Search from Public Video Sources
Public Video Library
Search Public — by Text
Semantic text search across the public TikTok / YouTube / Instagram video library.
POST
Search from Public Video Sources
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)Prerequisites
- You have created a memories.ai API key.
Request Example
Parameters
Natural-language search query. Must be non-empty.
What to search. The server-side enum is
[BY_CLIP, BY_VIDEO, BY_AUDIO, BY_IMAGE]; only the first three are meaningful here (BY_IMAGE is exposed via the dedicated Search Public — by Image endpoint).BY_VIDEO— video clips (default).BY_CLIPis an accepted alias.BY_AUDIO— spoken-word transcripts (semantic, not exact-match).audio_tsis only populated in the response for this mode.
code: "0003" and a JSON deserialization error listing the live enum values.Platform to search. One of
TIKTOK, YOUTUBE, INSTAGRAM. The server does not validate this string — passing an unknown value silently falls back to a default rather than returning an error, so prefer one of the documented values explicitly.Maximum results to return. Range: 1 – 1000.
Minimum similarity score threshold:
low— score ≥ 0.15medium— score ≥ 0.225high— score ≥ 0.4
Response
Public video identifier (typically prefixed with
PI-).Public video title or name.
Matched segment start time, in seconds.
Matched segment end time, in seconds.
Transcript text of the segment. Populated for
BY_AUDIO searches.Relevance score. Higher is more relevant.
GCS bucket of our cached copy of the public video. Omitted when the storage location cannot be resolved.
GCS blob (object) path of the cached video. Use it with
video_bucket at GET /serve/api/v2/download?bucket=&blob= to fetch the file directly.GCS bucket of the matched keyframe image (
BY_CLIP only).GCS blob (object) path of the matched keyframe image.
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
Body
application/json
Natural-language search query. Must be non-empty.
Example:
"Find sprint race with Usain Bolt"
Search modality. Only BY_VIDEO and BY_AUDIO are accepted here; BY_CLIP and BY_IMAGE are explicitly rejected. BY_VIDEO is treated as BY_CLIP internally.
Available options:
BY_VIDEO, BY_AUDIO Example:
"BY_VIDEO"
Source platform to search within.
Available options:
TIKTOK, YOUTUBE, INSTAGRAM Maximum number of results to return. Range 1-1000.
Required range:
1 <= x <= 1000Similarity-score filter. low=0.15, medium=0.225, high=0.4.
Available options:
low, medium, high Example:
"medium"
