Transcript API
Fetch transcript segments and apply bulk corrections programmatically.
Transcripts drive captions, editing, and AI analysis. You can fetch full transcripts, chunked segments, and perform bulk corrections.
Endpoints
POST /v1/projects/{project_id}/transcribeGET /v1/projects/{project_id}/transcriptGET /v1/projects/{project_id}/transcript/segmentsPOST /v1/projects/{project_id}/transcript/corrections
Start a Transcription Job
curl -X POST https://www.blitzreels.com/api/v1/projects/{project_id}/transcribe \
-H "Authorization: Bearer $BLITZREELS_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "media_id": "media-asset-uuid" }'Get Transcript
curl "https://www.blitzreels.com/api/v1/projects/{project_id}/transcript?media_id={asset_id}" \
-H "Authorization: Bearer $BLITZREELS_API_KEY"Get Transcript Segments
Segments are useful for editing and AI‑assisted highlights.
curl "https://www.blitzreels.com/api/v1/projects/{project_id}/transcript/segments?chunk_strategy=sentence" \
-H "Authorization: Bearer $BLITZREELS_API_KEY"Bulk Corrections
Use bulk corrections for common typos or proper nouns. This updates both transcripts and caption words.
curl -X POST https://www.blitzreels.com/api/v1/projects/{project_id}/transcript/corrections \
-H "Authorization: Bearer $BLITZREELS_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"media_asset_id": "media-asset-uuid",
"replacements": [
{ "from": "Virgil", "to": "Virgile", "match_case": false, "match_whole_word": true }
],
"phrase_replacements": [
{ "from_words": ["Cloud", "Code"], "to_words": ["Claude", "Code"], "match_case": false }
]
}'You can also use a timeline_item_id if you only have the clip reference.
replacements are single-token only. Use phrase_replacements for phrase fixes; v1 requires from_words and to_words to have the same token count so word timing stays stable.
Tips
- Poll job status or use webhooks before requesting transcripts.
- Use
chunk_strategy=time-windowfor consistent segment durations. - For single‑word corrections, use the Captions API.