video_url) or its 11-character ID (video_id), and get the
transcript back as XML, JSON, VTT, or SRT. All routes are POST under /api/v1 and
authenticate with the X-API-KEY header (see Authentication).
Endpoints
| Endpoint | Tier | What it does |
|---|---|---|
POST /youtube/transcript/v2 | Basic | Get a video’s transcript in xml / json / vtt / srt |
POST /youtube/metadata | Pro | Get title, author, thumbnails, channel info, and view/like counts |
youtube/metadata requires a Pro license — a Basic key gets 403 Pro account required.
The same applies to the with_metadata option on the transcript endpoint: the transcript
itself returns on Basic, but the metadata block is filled only for Pro keys (Basic sees
an upgrade placeholder). See Authentication.Notes
- Pick one identifier. Send either
video_urlorvideo_id— not both required. - Format defaults to
xml. Choosejsonfor structured segments with start/duration, orsrt/vttwhen you need subtitle files. - Rate limited. Both endpoints are rate limited; space out bulk calls.
retry_infoin every response reports fetch attempts — useful when a transcript is temporarily unavailable and you want to retry.

