[中文]

用途:

获取视频的字幕列表或指定语言的字幕内容

支持多种字幕格式输出

参数:

video_id: 视频ID（推荐）

video_url: 完整的视频URL（可选）

language_code: 语言代码（如 en, zh-Hans, a.en），为空时返回可用字幕列表

format: 字幕格式

srt: SubRip 字幕格式（带时间轴）

xml: 原始 XML 格式

json3: JSON 格式（YouTube 原始结构）

txt: 纯文本（无时间轴）

使用流程:

不传 language_code，获取字幕列表

从列表中选择 language_code，获取字幕内容

返回数据:

不传 language_code 时（字幕列表）:

{
  "captions": [
    {
      "language_code": "en",
      "language_name": "English",
      "kind": "",
      "is_translatable": true,
      "base_url": "xxxx"
    },
    {
      "language_code": "a.en",
      "language_name": "English (auto-generated)",
      "kind": "asr",
      "is_translatable": true,
      "base_url": "xxxx"
    }
  ]
}

传 language_code 时（字幕内容）:

format=srt: 标准 SRT 字幕文件内容（含序号、时间轴、文本）

format=txt: 纯文本（仅文字，无时间轴）

format=xml: YouTube 原始 XML 字幕

format=json3: YouTube JSON 格式字幕

注意事项:

kind 为 "asr" 表示自动生成的字幕

并非所有视频都有字幕

video_id 和 video_url 至少提供一个

价格:

$0.001 USD / 请求

[English]

Purpose:

Get video caption list or caption content for a specific language

Supports multiple caption format outputs

Parameters:

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 structure)

txt: Plain text (no timestamps)

Returns:

Without language_code (caption list):

{
  "captions": [
    {
      "language_code": "en",
      "language_name": "English",
      "kind": "",
      "is_translatable": true,
      "base_url": "xxxx"
    },
    {
      "language_code": "a.en",
      "language_name": "English (auto-generated)",
      "kind": "asr",
      "is_translatable": true,
      "base_url": "xxxx"
    }
  ]
}

With language_code (caption content):

format=srt: Standard SRT subtitle content (with sequence numbers, timestamps, text)

format=txt: Plain text (text only, no timestamps)

format=xml: YouTube raw XML captions

format=json3: YouTube JSON format captions

Usage flow:

Call without language_code to get available caption list

Select language_code from the list to get caption content

Notes:

kind="asr" indicates auto-generated captions

Not all videos have captions

At least one of video_id or video_url is required

Price:

$0.001 USD / request

[示例/Example]

Step 1 - 获取字幕列表: GET /get_video_captions?video_id=dQw4w9WgXcQ

Step 2 - 获取字幕内容: GET /get_video_captions?video_id=dQw4w9WgXcQ&language_code=en&format=srt

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

curl --location 'https://api.tikhub.io/api/v1/youtube/web_v2/get_video_captions?video_id=dQw4w9WgXcQ&video_url=https%3A%2F%2Fwww.youtube.com%2Fwatch%3Fv%3DdQw4w9WgXcQ&language_code=en&format=srt' \ --header 'Authorization: Bearer <token>'

{ "code": 200, "request_id": "string", "message": "Request successful. This request will incur a charge.", "message_zh": "请求成功，本次请求将被计费。", "support": "Discord: https://discord.gg/aMEAS8Xsvz", "time": "string", "time_stamp": 0, "time_zone": "America/Los_Angeles", "docs": "string", "cache_message": "string", "cache_message_zh": "string", "cache_url": "string", "router": "", "params": {}, "data": null }

获取视频字幕/Get video captions

[中文]

用途:

参数:

使用流程:

返回数据:

不传 language_code 时（字幕列表）:

传 language_code 时（字幕内容）:

注意事项:

价格:

[English]

Purpose:

Parameters:

Returns:

Without language_code (caption list):

With language_code (caption content):

Usage flow:

Notes:

Price:

[示例/Example]

Step 1 - 获取字幕列表: GET /get_video_captions?video_id=dQw4w9WgXcQ

Step 2 - 获取字幕内容: GET /get_video_captions?video_id=dQw4w9WgXcQ&language_code=en&format=srt

Request

Responses

获取视频字幕/Get video captions

[中文]#

用途:#

参数:#

使用流程:#

返回数据:#

不传 language_code 时（字幕列表）:#

传 language_code 时（字幕内容）:#

注意事项:#

价格:#

[English]#

Purpose:#

Parameters:#

Returns:#

Without language_code (caption list):#

With language_code (caption content):#

Usage flow:#

Notes:#

Price:#

[示例/Example]#

Step 1 - 获取字幕列表: GET /get_video_captions?video_id=dQw4w9WgXcQ#

Step 2 - 获取字幕内容: GET /get_video_captions?video_id=dQw4w9WgXcQ&language_code=en&format=srt#

Request

Responses

[中文]

用途:

参数:

使用流程:

返回数据:

不传 language_code 时（字幕列表）:

传 language_code 时（字幕内容）:

注意事项:

价格:

[English]

Purpose:

Parameters:

Returns:

Without language_code (caption list):

With language_code (caption content):

Usage flow:

Notes:

Price:

[示例/Example]

Step 1 - 获取字幕列表: GET /get_video_captions?video_id=dQw4w9WgXcQ

Step 2 - 获取字幕内容: GET /get_video_captions?video_id=dQw4w9WgXcQ&language_code=en&format=srt