Skip to main content

List transcript tracks

List the transcript tracks a video offers — each with its language and whether it is auto-generated — without downloading the transcripts themselves.

GET /v1/youtube/video/{video_id}/transcripts

Path parameter​

ParameterDescription
video_idThe 11-character video id, e.g. dQw4w9WgXcQ. See identifiers.

Example​

curl "$LISTENX_BASE/v1/youtube/video/abc123XYZ01/transcripts" \
-H "X-API-Key: $LISTENX_KEY"

Response​

{
"video": "abc123XYZ01",
"returned": 3,
"results": [
{ "language": "English", "language_code": "en", "is_generated": true },
{ "language": "English (United Kingdom)", "language_code": "en-GB", "is_generated": false },
{ "language": "Spanish", "language_code": "es", "is_generated": true }
],
"billing": {
"endpoint": "youtube.transcripts",
"units": 1,
"unit_price": "0.010000",
"amount": "0.010000",
"balance_after": "19.990000",
"request_id": "…"
}
}

Fields​

FieldDescription
videoThe video id.
returnedNumber of transcript tracks available.
results[]Available tracks.

Track​

FieldDescription
languageTranscript language name, e.g. English.
language_codeTranscript language code, e.g. en.
is_generatedtrue if auto-generated rather than creator-provided.

Pass a language_code from here to the transcript endpoint via its languages parameter.

Billing​

Billed per request — 1 unit per call. See Billing.

Errors​

HTTPcodeMeaning
404not_foundNo transcripts are available (none published, or disabled for the video).
429upstream_rate_limitedTransient upstream block — retry with backoff.