Path Parameters
The YouTube video id (e.g. dQw4w9WgXcQ).
Query Parameters
Preferred transcript language code (e.g. en, de). Falls back to the default available track.
Track type preference: manual (human-authored) or asr (auto-generated).
Response
The video the transcript belongs to.
Language code of the returned transcript (nullable).
Human-readable language name (nullable).
Track type: manual or asr (auto-generated) (nullable).
Whether the track can be machine-translated (nullable).
Other available transcript tracks (with language metadata).
Languages the transcript can be translated into.
Timed transcript lines. Show TranscriptSegment object
Segment start offset in milliseconds (nullable).
Segment end offset in milliseconds (nullable).
Segment duration in milliseconds (nullable).
Start offset as displayed, e.g. 0:12 (nullable).
The line text (nullable).
The entire transcript as a single plain-text string (nullable).
The transcript formatted as a ready-to-use SubRip (.srt) file (nullable).
The transcript formatted as a ready-to-use WebVTT (.vtt) file (nullable).
Example Response
Available Caption Tracks
To list the caption tracks for a video without downloading the full transcript, call:
This returns a CaptionsResponse with video_id, a tracks array (each with language, language_name, type, is_translatable, base_url), and translation_languages. The captions endpoint costs 3 credits .
A transcript request costs 8 credits ; the /captions listing costs 3 credits . Failed requests are not charged.