[中文]

用途:

获取 YouTube 视频详情（备用获取路径，字段提取更稳定）

适用场景: v1 /get_video_info 返回 title/author 为空时
（年龄限制、未公开、部分音乐视频等）

参数详解:

📌 必选参数（二选一）:

video_id (string)

作用: 视频ID

示例: "dQw4w9WgXcQ"

video_url (string)

作用: 视频URL（如果提供 video_id 则忽略此参数）

示例: "https://www.youtube.com/watch?v=dQw4w9WgXcQ"

⚙️ 可选参数:

need_format (bool, 可选)

作用: 是否返回清洗后的字段字典

默认值: True

True: 返回精简的字段字典（title / author / view_count 等）

False: 返回完整原始数据

与 get_video_info 的区别:

get_video_info: 字段更全（含 like_count_text / merchandise / endscreen / super_title /
subscriber_count_text / is_verified 等），但部分场景下字段提取不稳定

get_video_info_v2 (本接口): 核心字段更稳定，但 v1 独有的部分附加字段不再返回

返回字段（need_format=True）:

video_id / title / author / channel_id / channel_url / publish_date /
description / length_seconds / view_count / rating / keywords /
thumbnail_url / playability_status / captions / chapters

[English]

Purpose:

Fetch YouTube video details via an alternative extraction path (more stable field extraction)

Use when v1 /get_video_info returns empty title/author (age-gated, unlisted, music videos, etc.)

Parameters:

📌 Required (one of):

video_id (string) - Video ID, e.g. "dQw4w9WgXcQ"

video_url (string) - Full video URL (ignored if video_id provided)

⚙️ Optional:

need_format (bool) - Whether to return cleaned payload. Default True

Difference from get_video_info:

get_video_info: Richer field set (like_count_text / merchandise / endscreen /
super_title / subscriber_count_text / is_verified, etc.), but less stable extraction
in some scenarios

get_video_info_v2 (this): More stable core fields, drops v1-only ancillary fields

[示例/Examples]

通过 video_id 获取 / Fetch by video_id

GET /youtube_web/get_video_info_v2?video_id=dQw4w9WgXcQ

通过 video_url 获取 / Fetch by video_url

GET /youtube_web/get_video_info_v2?video_url=https://www.youtube.com/watch?v=dQw4w9WgXcQ

返回原始数据 / Return raw payload

GET /youtube_web/get_video_info_v2?video_id=dQw4w9WgXcQ&need_format=false

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_info_v2?video_id=dQw4w9WgXcQ&video_url=https%3A%2F%2Fwww.youtube.com%2Fwatch%3Fv%3DdQw4w9WgXcQ&need_format=undefined' \ --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 }

获取视频详情 V2/Get video information V2

[中文]

用途:

参数详解:

📌 必选参数（二选一）:

⚙️ 可选参数:

与 get_video_info 的区别:

返回字段（need_format=True）:

[English]

Purpose:

Parameters:

📌 Required (one of):

⚙️ Optional:

Difference from get_video_info:

[示例/Examples]

通过 video_id 获取 / Fetch by video_id

通过 video_url 获取 / Fetch by video_url

返回原始数据 / Return raw payload

Request

Responses

获取视频详情 V2/Get video information V2

[中文]#

用途:#

参数详解:#

📌 必选参数（二选一）:#

⚙️ 可选参数:#

与 get_video_info 的区别:#

返回字段（need_format=True）:#

[English]#

Purpose:#

Parameters:#

📌 Required (one of):#

⚙️ Optional:#

Difference from get_video_info:#

[示例/Examples]#

通过 video_id 获取 / Fetch by video_id#

通过 video_url 获取 / Fetch by video_url#

返回原始数据 / Return raw payload#

Request

Responses

[中文]

用途:

参数详解:

📌 必选参数（二选一）:

⚙️ 可选参数:

与 get_video_info 的区别:

返回字段（need_format=True）:

[English]

Purpose:

Parameters:

📌 Required (one of):

⚙️ Optional:

Difference from get_video_info:

[示例/Examples]

通过 video_id 获取 / Fetch by video_id

通过 video_url 获取 / Fetch by video_url

返回原始数据 / Return raw payload