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
| Parameter | Description |
|---|---|
video_id | The 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
| Field | Description |
|---|---|
video | The video id. |
returned | Number of transcript tracks available. |
results[] | Available tracks. |
Track
| Field | Description |
|---|---|
language | Transcript language name, e.g. English. |
language_code | Transcript language code, e.g. en. |
is_generated | true 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
| HTTP | code | Meaning |
|---|---|---|
| 404 | not_found | No transcripts are available (none published, or disabled for the video). |
| 429 | upstream_rate_limited | Transient upstream block — retry with backoff. |