Get YouTube video transcript
Returns structured captions for a YouTube video when available. Pass `url` as a standard watch link (or equivalent). Optional `language` requests a preferred caption language when multiple tracks exist.
Operation
/v1/youtube/videos/transcriptHeaders
API key (`sfk_...`)
Parameters
Link to the YouTube video whose transcript should be returned.
min 1 chars · max 4096 chars
Optional ISO 639-1 language code (two letters) to prefer when multiple transcripts exist.
min 2 chars · max 2 chars
Response fields
Endpoint-specific response payload.
Outcome of the transcript lookup: resolved video, not found, or lookup could not be completed.
one of: found, not_found, lookup_failed
Video identity when the lookup resolved.
YouTube video id.
min 1 chars
Canonical public URL for the video.
min 1 chars
Transcript content when available for the resolved video.
Timed transcript segments.
Transcript segment text.
Segment start offset in milliseconds.
≥ 0
Segment end offset in milliseconds.
≥ 0
Full transcript text, typically derived from captions.
Human-readable transcript language label when reported by the lookup.
Metadata describing the request and billing outcome.
Unique request identifier for tracing this API call.
min 1 chars
Credits charged for this request.
≥ 0
Public API version that served the response.
one of: v1
Code example
Responses
Transcript lookup result. Inspect `data.lookupStatus` for found, not found, or lookup_failed.
Error codes