YouTube API
YouTube Subtitles
List available subtitle tracks for a YouTube video.
POST
$0.01/call/v1/youtube/subtitlesUsage
const res = await fetch('https://api.yepapi.com/v1/youtube/subtitles', {
method: 'POST',
headers: {
'x-api-key': 'YOUR_API_KEY',
'Content-Type': 'application/json',
},
body: JSON.stringify({ id: 'dQw4w9WgXcQ' }),
});
const { data } = await res.json();
console.log(data.subtitles);curl -X POST https://api.yepapi.com/v1/youtube/subtitles \
-H "x-api-key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"id": "dQw4w9WgXcQ"}'Request Body
| Parameter | Type | Required | Description | Default |
|---|---|---|---|---|
id | string | Yes | YouTube video ID | — |
Response
{
"ok": true,
"data": {
"format": "srv1",
"subtitles": [
{
"languageName": "English",
"languageCode": "en",
"isTranslatable": true,
"url": "https://www.youtube.com/api/timedtext?v=dQw4w9WgXcQ&lang=en&fmt=srv1"
},
{
"languageName": "English (auto-generated)",
"languageCode": "en",
"isTranslatable": true,
"url": "https://www.youtube.com/api/timedtext?v=dQw4w9WgXcQ&kind=asr&lang=en&fmt=srv1"
},
{
"languageName": "Japanese",
"languageCode": "ja",
"isTranslatable": true,
"url": "https://www.youtube.com/api/timedtext?v=dQw4w9WgXcQ&lang=ja&fmt=srv1"
}
],
"translationLanguages": [
{ "languageCode": "af", "languageName": "Afrikaans" },
{ "languageCode": "sq", "languageName": "Albanian" }
]
}
}Response Fields
| Field | Type | Description |
|---|---|---|
ok | boolean | Whether the request succeeded |
data.format | string | Subtitle format (e.g. srv1) |
data.subtitles | object[] | Array of available subtitle tracks |
data.subtitles[].languageName | string | Human-readable language name (e.g. English, Japanese) |
data.subtitles[].languageCode | string | ISO language code (e.g. en, ja, de-DE) |
data.subtitles[].isTranslatable | boolean | Whether the track supports auto-translation |
data.subtitles[].url | string | Direct URL to download the subtitle file |
data.translationLanguages | object[] | Available languages for auto-translation |
data.translationLanguages[].languageCode | string | ISO language code for translation target |
data.translationLanguages[].languageName | string | Human-readable language name for translation target |