Skip to main content
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)
Find video segments where a specific phrase was spoken. This is exact LIKE matching against stored audio transcripts, not semantic — use it when you know the phrase verbatim. For semantic audio search, use Search by Text with search_type=BY_AUDIO.

Prerequisites

Request Example

Parameters

query
string
required
Search phrase. LIKE-style exact matching against stored transcripts.
page
integer
default:"1"
One-based page number.
page_size
integer
default:"100"
Results per page. Range: 1 – 500.

Response

data.current_page
integer
Page number returned.
data.page_size
integer
Page size returned.
data.total_count
string
Total matching segments across all pages, returned as a string (int(total_count) to use it).
data.videos[].videoNo
string
Identifier of the video containing the matched segment.
data.videos[].videoName
string
Internal stored name of the video.
data.videos[].startTime
string
Segment start time in seconds (returned as string).
data.videos[].audio_ts
string
The matched transcript text.
data.videos[].video_bucket
string
GCS bucket of the original video file. Omitted when the storage location cannot be resolved.
data.videos[].video_blob
string
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

Authorization
string
header
required

Query Parameters

query
string
required

Audio transcript search text (LIKE match). Must be non-empty.

page
integer
default:1

One-based page number. Must be > 0.

Required range: x >= 1
page_size
integer
default:100

Results per page. Range 1-500.

Required range: 1 <= x <= 500

Response

200 - application/json

Successful response

code
string
Example:

"0000"

msg
string
Example:

"success"

data
object
success
boolean
Example:

true

failed
boolean
Example:

false