Search for words or phrases within a transcription and get matching segments with timestamps and confidence scores.
Searches for exact phrase matches within the transcription text. Returns all matching segments with their start and end timestamps (in seconds) and confidence scores. The search query supports 1 to 5 words with a maximum of 128 characters.
The transcription must be in completed or processing status for search to be available. If the transcription is still queued, a 409 Conflict error is returned.
When word-level data is available locally, the search is performed server-side without an upstream API call, resulting in faster response times.
transcription_id string required
The transcription ID with trans_ prefix.
query string required
The search query. Must be 1 to 128 characters and contain no more than 5 words.
Returns a success envelope with:
data.transcription_id-- The transcription ID.data.query-- The search query that was executed.data.matches-- Array of match objects, each containing:text-- The matched text.start-- Start time in seconds (3 decimal places).end-- End time in seconds (3 decimal places).confidence-- Confidence score (0.0 to 1.0).
data.total_count-- Total number of matches found.metadata-- Request metadata:request_id,timestamp,processing_time_ms,upstream_latency_ms.
- Bash
- Python
- Python
- JavaScript
curl -s -X GET "https://api.aitronos.com/v1/audio/transcribe/trans_a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6/search?query=quarterly%20results" \
-H "Authorization: Bearer $ACCESS_TOKEN" | python3 -m json.tool