Skip to main content
POST
Run a hybrid (semantic + keyword) search across an end user’s transcripts and get back the most relevant excerpts. Each result carries start_ms/end_ms so you can deep-link a citation back to the moment in the audio. This is the retrieval primitive behind cross-recording AI Ask.

Authentication

Requires an API key with recordings:read scope.

Request Body

string
required
Natural-language search query (1–1000 characters).
string
End user whose recordings to search (eu_*). Required unless the API key is itself scoped to an end user.
string[]
Restrict the search to these recordings. Omit to search all of the end user’s recordings.
string
Only include chunks from recordings on or after this time (ISO 8601).
string
Only include chunks from recordings before this time (ISO 8601).
integer
default:"8"
Maximum number of chunks to return (1–50).

Response

Returns the top-K most relevant transcript chunks, best first.

Response Fields

Search only covers recordings that have a completed transcription — chunking + embedding runs automatically after transcription completes.