Search from Audio
Private Video Library
Search by Transcript
Exact keyword search across stored audio transcripts in your Private Video Library.
GET
Search from Audio
Product: Visual Search
Use case: Upload videos and images, auto-index them, then search by natural language, image, or transcript phrase
Host:
https://api.memories.ai/serve/api/v1
Auth: Authorization: sk-mavi-... (no Bearer prefix)search_type=BY_AUDIO.
Prerequisites
- You have created a memories.ai API key.
- The target videos have an audio track and have finished parsing.
Request Example
Parameters
Search phrase. LIKE-style exact matching against stored transcripts.
One-based page number.
Results per page. Range: 1 – 500.
Response
Page number returned.
Page size returned.
Total matching segments across all pages, returned as a string (
int(total_count) to use it).Identifier of the video containing the matched segment.
Internal stored name of the video.
Segment start time in seconds (returned as string).
The matched transcript text.
GCS bucket of the original video file. Omitted when the storage location cannot be resolved.
GCS blob (object) path of the original video. Use it with
video_bucket at GET /serve/api/v2/download?bucket=&blob= to fetch the file directly.Notes & Limits
- Rate limiting: Exceeding the per-account rate limit returns an error. See Rate limits.
- Billing: Each successful call deducts credits from your account balance.
Authorizations
Query Parameters
Audio transcript search text (LIKE match). Must be non-empty.
One-based page number. Must be > 0.
Required range:
x >= 1Results per page. Range 1-500.
Required range:
1 <= x <= 500