--- title: "获取帖子评论/Get post comments" method: GET path: "/api/v1/youtube/web_v2/get_post_comments" tags: ["YouTube-Web-V2-API"] --- # 获取帖子评论/Get post comments `GET /api/v1/youtube/web_v2/get_post_comments` ## Request - Base URL: `https://api.tikhub.io` (the document declares no server; this is the origin it was published from) - URL: `https://api.tikhub.io/api/v1/youtube/web_v2/get_post_comments` - Auth: HTTP bearer # [中文] ### 用途: - 获取YouTube帖子（社区帖子）的评论列表 - 支持分页获取更多评论 ### 参数详解: #### 参数（至少提供一个）: **post_id** (string) - **作用**: 帖子ID，首次请求时必填 - **获取方式**: 从帖子URL中提取，例如 `https://www.youtube.com/post/UgkxiCSRfD6g7SPlWGPDa3vbP7aIsytXRkvy` - **示例**: `"UgkxiCSRfD6g7SPlWGPDa3vbP7aIsytXRkvy"` **continuation_token** (string) - **作用**: 分页token - **获取方式**: - 从 `get_post_detail` 返回的 `comments_continuation_token` 字段获取（首次请求） - 或从上一次评论请求的响应中获取 `continuation_token`（分页请求） #### 可选参数: **language_code** (string, 可选) - 语言代码，默认 `"zh-CN"` **country_code** (string, 可选) - 国家代码，默认 `"US"` **need_format** (bool, 可选) - 是否格式化数据，默认 `true` ### 返回数据 (need_format=true): - comments: 评论列表 - comment_id: 评论ID - content: 评论内容文本 - published_time: 发布时间 - like_count: 点赞数 - like_count_a11y: 点赞数无障碍文本 - reply_count: 回复数 - reply_count_text: 回复数文本 - reply_continuation_token: 回复的continuation token（用于获取二级评论） - author: 作者信息 - channel_id: 作者频道ID - display_name: 显示名称 - channel_url: 频道URL - avatar_url: 头像URL - is_verified: 是否认证 - is_creator: 是否为创作者 - continuation_token: 下一页评论的分页token ### 使用流程: 1. 首次请求：传入 post_id（或从 get_post_detail 获取 comments_continuation_token 作为 continuation_token） 2. 获取响应中的 continuation_token 3. 下次请求：传入 continuation_token 获取更多评论 4. 每条评论如有回复，可用 reply_continuation_token 调用 get_post_comment_replies ### 价格: - $0.001 USD / 请求 # [English] ### Purpose: - Get YouTube post (community post) comments - Supports pagination for more comments ### Parameters: #### Required (at least one): **post_id** (string) - Post ID, required for first request **continuation_token** (string) - Pagination token (from get_post_detail's comments_continuation_token or previous response) #### Optional: **language_code** (string, optional) - Language code, default `"zh-CN"` **country_code** (string, optional) - Country code, default `"US"` **need_format** (bool, optional) - Whether to format data, default `true` ### Returns (need_format=true): - comments: Comments list - comment_id, content, published_time, like_count, reply_count - reply_continuation_token: Token for fetching replies - author: Author info (channel_id, display_name, avatar_url, etc.) - continuation_token: Next page token ### Usage Flow: 1. First request: Pass post_id (or use comments_continuation_token from get_post_detail) 2. Get continuation_token from response 3. Next request: Pass continuation_token for more comments 4. Use reply_continuation_token to get replies via get_post_comment_replies ### Price: - $0.001 USD / request ### [示例/Example] #### 获取帖子评论: post_id = "UgkxiCSRfD6g7SPlWGPDa3vbP7aIsytXRkvy" ## Query parameters - `post_id` string: 帖子ID（首次请求时必填）/Post ID (required for first request) - `continuation_token` string: 分页token（分页时必填，也可用 get_post_detail 返回的 comments_continuation_token）/Pagination token - `language_code` string: 语言代码（如zh-CN, en-US等）/Language code - `country_code` string: 国家代码（如US, JP等）/Country code - `need_format` boolean: 是否需要清洗数据，提取关键内容，移除冗余数据/Whether to clean and format the data ## Response `200` Successful Response - ResponseModel - `code` integer: HTTP status code | HTTP状态码 - `request_id` string, nullable: Unique request identifier | 唯一请求标识符 - `message` string: Response message (EN-US) | 响应消息 (English) - `message_zh` string: Response message (ZH-CN) | 响应消息 (中文) - `support` string: Support message | 支持消息 - `time` string: The time the response was generated | 生成响应的时间 - `time_stamp` integer: The timestamp the response was generated | 生成响应的时间戳 - `time_zone` string: The timezone of the response time | 响应时间的时区 - `docs` string, nullable: Link to the API Swagger documentation for this endpoint | 此端点的 API Swagger 文档链接 - `cache_message` string, nullable: Cache message (EN-US) | 缓存消息 (English) - `cache_message_zh` string, nullable: Cache message (ZH-CN) | 缓存消息 (中文) - `cache_url` string, nullable: The URL to access the cached result | 访问缓存结果的 URL - `router` string: The endpoint that generated this response | 生成此响应的端点 - `params` unknown - `data` unknown ## Other responses - `422`: Validation Error ## Changes - **2026-10-08** `96a122a5f220`: 2 info - added the optional property `detail/items/ctx` to the response with the `422` status - added the optional property `detail/items/input` to the response with the `422` status - **2026-09-01** `50f9ec6e1cd3`: 2 info - the `cache_message` response's property default value changed from `This request will be cached. You can access the cached result directly using the URL below, valid for 24 hours. Accessing the cache will not incur additional charges.` to `This response is cached and accessible via the URL below for 24 hours at no extra cost. The cache is for request tracing only — it doesn't affect the API's data freshness and won't be returned through the API again.` for the status `200` - the `cache_message_zh` response's property default value changed from `本次请求将被缓存，你可以使用下面的 URL 直接访问缓存结果，有效期为 24 小时，访问缓存不会产生额外费用。` to `本次响应已缓存，可通过下方 URL 直接查看，有效期 24 小时，访问缓存链接无额外费用。缓存仅用于请求溯源，不影响接口数据的时效性，也不会再次通过接口返回。` for the status `200` - **2026-04-14** `ee5b7c9c88f5`: 1 info - endpoint added [Operation history](https://skmtc.dev/tikhub/apis/tikhub-douyin-tiktok-xiaohongshu-lemon8-bilibili-kuaishou-pi/changes/api/v1/youtube/web_v2/get_post_comments/get.md) --- [API](https://skmtc.dev/tikhub/apis/tikhub-douyin-tiktok-xiaohongshu-lemon8-bilibili-kuaishou-pi.md) - [All operations](https://skmtc.dev/tikhub/apis/tikhub-douyin-tiktok-xiaohongshu-lemon8-bilibili-kuaishou-pi/llms.txt) - [OpenAPI document](https://skmtc.dev/tikhub/apis/tikhub-douyin-tiktok-xiaohongshu-lemon8-bilibili-kuaishou-pi/revisions/86a3483c705a?raw)