Get a video transcript (segments, speakers, entity annotations)
Transcript surfaces are premium-only. Access requires a permanent per-video unlock (paid tiers). Cost is always quoted in rows and 15-minute blocks: 125 rows per 15-minute block of video, minimum one block. access states: unlocked (full premium transcript), locked (premium transcript exists — ~5 teaser segments + meta.quote; pass ?unlock=true to debit the quoted rows and receive the full transcript in the same request), premium_pending (a preliminary analysis exists but premium transcription has not run — the payload carries ONLY detected entity-type counts { people, organizations, products, topics } plus the quote; run the premium analysis via POST /v1/transcriptions; unlock=true is ignored in this state), not_transcribed (not in the index — submit via POST /v1/transcriptions). Unlocks are permanent — subsequent reads are free, and an unlock bought before the premium transcript existed makes the later premium generation free. The response meta.revision is an opaque id for the served transcript + approved-correction state; echo it back when submitting corrections.
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Query Parameters
Explicit purchase action: debits quarters × 125 rows and grants the permanent per-video unlock in the same request. Without it, locked viewers receive only the teaser segments.
true Response
Success