Skip to main content
GET
/
serve
/
api
/
v1
/
search_audio_transcripts
Search from Audio
curl --request GET \
  --url https://api.memories.ai/serve/api/v1/search_audio_transcripts \
  --header 'Authorization: <api-key>'
{
  "code": "0000",
  "msg": "success",
  "data": {
    "current_page": 1,
    "page_size": 100,
    "total_count": 2,
    "videos": [
      {
        "videoNo": "VI576925607808602112",
        "videoName": "1920447021987282945",
        "startTime": "13",
        "audio_ts": "... where is the love ...",
        "video_bucket": "mavi-resource",
        "video_blob": "VI576925607808602112.mp4"
      }
    ]
  },
  "success": true,
  "failed": false
}

Documentation Index

Fetch the complete documentation index at: https://api-tools.memories.ai/llms.txt

Use this file to discover all available pages before exploring further.

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

import requests

headers = {"Authorization": "sk-mavi-..."}
params = {
    "query": "where is the love",
    "page": 1,
    "page_size": 100,
    "unique_id": "default"
}

response = requests.get(
    "https://api.memories.ai/serve/api/v1/search_audio_transcripts",
    headers=headers,
    params=params
)
print(response.json())

​
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.
​
unique_id
string
default:"default"
Namespace scoping the search to a folder in your account.

​
Response

{
    "code": "0000",
    "msg": "success",
    "data": {
        "current_page": 1,
        "page_size": 100,
        "total_count": "2",
        "videos": [
            {
                "videoNo": "VI576925607808602112",
                "videoName": "1920447021987282945",
                "startTime": "13",
                "audio_ts": "... where is the love ...",
                "video_bucket": "mavi-resource",
                "video_blob": "VI576925607808602112.mp4"
            }
        ]
    },
    "success": true,
    "failed": false
}
​
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
​
unique_id
string
default:default

Unique ID scope.

Response

200 - application/json

Successful response

​
code
string
Example:

"0000"

​
msg
string
Example:

"success"

​
data
object
​
success
boolean
Example:

true

​
failed
boolean
Example:

false