Skip to content
Gridlode
Docs · Reference

YouTube Transcript

GET /v1/youtube/transcript1 credit / requestcache 10080 min

The captions of one YouTube video in the language you ask for, as timed segments (start, duration, text) plus the full text. Human-made captions are preferred and YouTube's auto-generated ones are the fallback; the response says which you got and lists every caption language on offer. Uses only the caption tracks the public watch page links to. Videos without captions in that language, verification pages, blocks and failures are free.

Query parameters

video_id
string · required
YouTube video ID (11 characters) or any youtube.com / youtu.be video, Shorts or live URL.
lang
string
Caption language, e.g. en, de, pt-BR. 'en' also matches regional tracks such as en-GB.
Default: "en"
kind
string
any: human-made captions when they exist, else YouTube's auto-generated ones. manual / auto: only that kind.
Default: "any"
Allowed: any, manual, auto
hl
string
Interface language of the watch page.
Default: "en"
gl
string
Two-letter country code to view the video from.
Default: "us"
max_age
integer
Accept a cached answer up to this many seconds old, billed at 50%.

Response data fields

    Example

    curl "https://api.gridlode.com/v1/youtube/transcript?video_id=aircAruvnKk&lang=en" \
  -H "Authorization: Bearer $GRIDLODE_KEY"

    Try it without code on the YouTube Transcript API page.