Skip to main content

GET /v1/youtube/web_v2/get_video_captions

Get video captions

stable · 11 credits per success

Get video caption list or caption content for a specific language;Supports multiple caption format outputs;video_id: Video ID (recommended);video_url: Full video URL (optional);language_code: Language code (e.g. en, zh-Hans, a.en), returns available caption list if empty;format: Caption format;- srt: SubRip subtitle format (with timestamps);- xml: Raw XML format;- json3: JSON format (YouTube raw …

Sign up for 500 credits and run with your own API key. Sign up free

Request

curl
curl -s 'https://api.wellbyte.net/v1/youtube/web_v2/get_video_captions?format=srt&video_id=dQw4w9WgXcQ&video_url=https%3A%2F%2Fwww.youtube.com%2Fwatch%3Fv%3DdQw4w9WgXcQ&language_code=en' \
  -H "Authorization: Bearer dg_live_…"

Response

Sample captured 2026-09-23

data{
code:0
data{
format:"srt"
content:
"1 00:00:01,360 --> 00:00:03,040 [♪♪♪] 2 00:00:18,640 --> 00:00:21,880 ♪ We're n..."
video_id:"dQw4w9WgXcQ"
language_code:"en"
language_name:"English"
}
meta{
endpoint:"youtube.web_v2.get_video_captions"
cache_hit:false
elapsed_ms:0
request_id:"req_sample"
credits_charged:0
}
message:"ok"
}

No calls yet. Get one green run first, then switch to your own data.

    Request parameters

    NameTypeInRequiredDescriptionExample
    formatstringqueryno字幕格式srt
    video_idstringqueryno视频IDdQw4w9WgXcQ
    video_urlstringqueryno视频URLhttps://www.youtube.com/watch?v=dQw4w9WgXcQ
    language_codestringqueryno语言代码,为空时返回可用字幕列表en

    Response fields

    Field dictionary coming soon — the executable panel shows the live shape.

    Errors

    codeHTTPMeaningBilled
    40001400Invalid parametersno
    40102401Invalid or revoked API Keyno
    40201402Insufficient creditsno
    40402404Resource not foundno
    42201422Quality gate failedno
    42901429Rate limit exceededno
    50401504Upstream timeoutno
    50201502Upstream errorno

    Billing

    Success costs 11 credits. Any failure — including a 200 that fails the quality gate — costs 0.

    All YouTube endpoints →

    Search

    Search endpoints and docs