[中文]

用途:

获取YouTube视频的一级评论

参数详解:

📌 必选参数:

video_id (string)

作用: 视频ID

格式: YouTube视频ID字符串

示例: "oaSNBz4qMQY"

获取方式: 从URL https://www.youtube.com/watch?v=oaSNBz4qMQY 中提取

⚙️ 可选参数:

language_code (string, 可选)

作用: 设置评论显示的语言偏好

默认值: "zh-CN"

可用值: "zh-CN", "en-US", "ja-JP", "ko-KR" 等

country_code (string, 可选)

作用: 设置地区代码

默认值: "US"

可用值: "US", "JP", "GB" 等

sort_by (string, 可选)

作用: 评论排序方式

默认值: "top"

可用值:

"top" - 热门评论（按点赞数排序）

"newest" - 最新评论（按时间排序）

continuation_token (string, 可选)

作用: 翻页令牌，用于获取下一页评论

默认值: null

获取方式: 从上一次请求的响应中提取

need_format (boolean, 可选)

作用: 是否返回清洗后的精简数据

默认值: false

可用值:

false - 返回原始完整数据

true - 返回清洗后的精简数据（推荐）

返回数据结构 (need_format=true):

{
  "comments": [
    {
      "comment_id": "UgzRDoUJAvDNn5_8i8p4AaABAg",
      "content": "评论内容文本",
      "published_time": "1天前",
      "reply_level": 0,
      "like_count": "2",
      "like_count_a11y": "2 次赞",
      "reply_count": "0",
      "reply_count_a11y": "0 条回复",
      "reply_count_text": "1 条回复",
      "reply_continuation_token": "...",
      "author": {
        "channel_id": "UCzRzHrLFuH0lHZYnrI84I8Q",
        "display_name": "@username",
        "channel_url": "https://www.youtube.com/@username",
        "avatar_url": "https://yt3.ggpht.com/...",
        "avatar_thumbnails": [
          {"url": "...", "width": 88, "height": 88}
        ],
        "is_verified": false,
        "is_creator": false,
        "is_artist": false
      },
      "creator_thumbnail_url": "https://yt3.ggpht.com/..."
    }
  ],
  "continuation_token": "下一页token"
}

字段说明:

comment_id: 评论唯一ID

content: 评论文本内容

published_time: 发布时间（相对时间，如"1天前"）

reply_level: 回复层级（0表示一级评论）

like_count: 点赞数

reply_count: 回复数

reply_count_text: 回复数文本（如"1 条回复"）

reply_continuation_token: 获取该评论回复的token

author: 评论作者信息

channel_id: 作者频道ID

display_name: 显示名称

channel_url: 频道URL

avatar_url: 头像URL

is_verified: 是否已认证

is_creator: 是否为视频创作者

is_artist: 是否为音乐人

creator_thumbnail_url: 视频创作者头像URL

[English]

Purpose:

Get YouTube video first-level comments

Parameters:

📌 Required:

video_id (string)

Purpose: Video ID

Format: YouTube video ID string

Example: "oaSNBz4qMQY"

How to get: Extract from URL https://www.youtube.com/watch?v=oaSNBz4qMQY

⚙️ Optional:

language_code (string, optional)

Purpose: Set language preference for comments

Default: "zh-CN"

Values: "zh-CN", "en-US", "ja-JP", "ko-KR", etc.

country_code (string, optional)

Purpose: Set region code

Default: "US"

Values: "US", "JP", "GB", etc.

sort_by (string, optional)

Purpose: Comment sorting method

Default: "top"

Values:

"top" - Top comments (sorted by likes)

"newest" - Newest comments (sorted by time)

continuation_token (string, optional)

Purpose: Pagination token for next page

Default: null

How to get: Extract from previous response

need_format (boolean, optional)

Purpose: Whether to return cleaned simplified data

Default: false

Values:

false - Return raw complete data

true - Return cleaned simplified data (recommended)

Response Structure (need_format=true):

{
  "comments": [
    {
      "comment_id": "UgzRDoUJAvDNn5_8i8p4AaABAg",
      "content": "Comment text content",
      "published_time": "1 day ago",
      "reply_level": 0,
      "like_count": "2",
      "like_count_a11y": "2 likes",
      "reply_count": "0",
      "reply_count_a11y": "0 replies",
      "reply_count_text": "1 reply",
      "reply_continuation_token": "...",
      "author": {
        "channel_id": "UCzRzHrLFuH0lHZYnrI84I8Q",
        "display_name": "@username",
        "channel_url": "https://www.youtube.com/@username",
        "avatar_url": "https://yt3.ggpht.com/...",
        "avatar_thumbnails": [
          {"url": "...", "width": 88, "height": 88}
        ],
        "is_verified": false,
        "is_creator": false,
        "is_artist": false
      },
      "creator_thumbnail_url": "https://yt3.ggpht.com/..."
    }
  ],
  "continuation_token": "next page token"
}

Field Descriptions:

comment_id: Unique comment ID

content: Comment text content

published_time: Published time (relative, e.g., "1 day ago")

reply_level: Reply level (0 for first-level comments)

like_count: Number of likes

reply_count: Number of replies

reply_count_text: Reply count text (e.g., "1 reply")

reply_continuation_token: Token to get replies for this comment

author: Comment author info

channel_id: Author's channel ID

display_name: Display name

channel_url: Channel URL

avatar_url: Avatar URL

is_verified: Whether verified

is_creator: Whether video creator

is_artist: Whether artist

creator_thumbnail_url: Video creator's avatar URL

[示例/Examples]

获取热门评论

GET /youtube_web/get_video_comments?video_id=oaSNBz4qMQY&sort_by=top

获取最新评论

GET /youtube_web/get_video_comments?video_id=oaSNBz4qMQY&sort_by=newest

获取清洗后的评论数据（推荐）

GET /youtube_web/get_video_comments?video_id=oaSNBz4qMQY&need_format=true

翻页获取更多评论

GET /youtube_web/get_video_comments?video_id=oaSNBz4qMQY&continuation_token=xxx&need_format=true

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/get_video_comments?video_id=LuIL5JATZsc&language_code=zh-CN&country_code=US&sort_by=undefined&continuation_token=undefined&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 }

获取视频评论/Get video comments

[中文]

用途:

参数详解:

📌 必选参数:

⚙️ 可选参数:

返回数据结构 (need_format=true):

字段说明:

[English]

Purpose:

Parameters:

📌 Required:

⚙️ Optional:

Response Structure (need_format=true):

Field Descriptions:

[示例/Examples]

获取热门评论

获取最新评论

获取清洗后的评论数据（推荐）

翻页获取更多评论

Request

Responses

获取视频评论/Get video comments

[中文]#

用途:#

参数详解:#

📌 必选参数:#

⚙️ 可选参数:#

返回数据结构 (need_format=true):#

字段说明:#

[English]#

Purpose:#

Parameters:#

📌 Required:#

⚙️ Optional:#

Response Structure (need_format=true):#

Field Descriptions:#

[示例/Examples]#

获取热门评论#

获取最新评论#

获取清洗后的评论数据（推荐）#

翻页获取更多评论#

Request

Responses

[中文]

用途:

参数详解:

📌 必选参数:

⚙️ 可选参数:

返回数据结构 (need_format=true):

字段说明:

[English]

Purpose:

Parameters:

📌 Required:

⚙️ Optional:

Response Structure (need_format=true):

Field Descriptions:

[示例/Examples]

获取热门评论

获取最新评论

获取清洗后的评论数据（推荐）

翻页获取更多评论