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 ..."
      }
    ]
  },
  "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.

​
Prerequisites

  • You’re familiar with the concepts described on the Platform overview.
  • You have created a memories.ai API key.
  • At least one video has been uploaded with audio transcription available (video in PARSE status with a transcript).

​
Host URL

https://api.memories.ai

​
Endpoint

GET /serve/api/v1/search_audio_transcripts 
/serve/api/v1/search_audio_transcripts

​
Authentication

Pass your API key in the Authorization request header. Requests without a valid API key are rejected. 
Authorization: <API_KEY>

​
Request Example

import requests

url = "https://api.memories.ai/serve/api/v1/search_audio_transcripts"
params = {
    "query": "where is the love",
    "page": 1,
    "page_size": 100,
    "unique_id": "default"
}
headers = {"Authorization": "<API_KEY>"}

response = requests.get(url, headers=headers, params=params)
print(response.json())

​
Query Parameters

​
query
string
required
The audio-transcript search text. Performs a LIKE-style exact-match against stored transcripts. Must be non-empty.
​
page
integer
default:"1"
One-based page number. Must be greater than 0.
​
page_size
integer
default:"100"
Number of results per page. Must be in the range 1 – 500 inclusive.
​
unique_id
string
default:"default"
Scope identifier for the authenticated account. Must be non-empty when explicitly provided.

​
Notes & Limits

  • Rate limiting: The endpoint is protected by a per-account audio-search rate limit. Exceeding the limit returns an error indicating the request has exceeded the limit.
  • Billing: This endpoint is metered — each successful call deducts points from your account balance.
  • Search algorithm: This endpoint performs exact (LIKE) matching over stored transcripts, not semantic search. For semantic audio search use POST /serve/api/v1/search with search_type=BY_AUDIO.

​
Response Example

{
    "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 ..."
            }
        ]
    },
    "success": true,
    "failed": false
}

​
Response Fields

​
code
string
Business status code. 0000 indicates success.
​
msg
string
Human-readable status message.
​
data.current_page
integer
The page number returned (echoes the page parameter).
​
data.page_size
integer
The page size returned (echoes the page_size parameter).
​
data.total_count
integer
Total number of matching transcript segments across all pages.
​
data.videos
array
List of matching transcript segments.
​
data.videos[].videoNo
string
Video identifier the matched transcript belongs to.
​
data.videos[].videoName
string
Internal stored name of the video.
​
data.videos[].startTime
string
Matched segment start time, in seconds (integer value, returned as string; no end time is provided for this endpoint).
​
data.videos[].audio_ts
string
The matched transcript text.

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