获取频道帖子列表/Get channel community posts

[中文]

用途:

• 获取YouTube频道的帖子（社区帖子）列表
• 支持分页获取，可通过 continuation_token 获取更多帖子

参数详解:

必选参数:

channel_id (string)

• 作用: 频道ID
• 获取方式: 从频道URL中提取，例如 https://www.youtube.com/channel/UCkRfArvrzheW2E7b6SVT7vQ
• 示例: "UCkRfArvrzheW2E7b6SVT7vQ"

可选参数:

language_code (string, 可选)

• 作用: 语言代码，影响返回的文本语言
• 默认值: "zh-CN"

country_code (string, 可选)

• 作用: 国家代码
• 默认值: "US"

continuation_token (string, 可选)

• 作用: 分页token，用于获取下一页帖子
• 获取方式: 从上一次请求的响应中获取

need_format (bool, 可选)

• 作用: 是否格式化数据
• 默认值: true

返回数据:

当 need_format=true 时:

• channel_id: 频道ID
• posts: 帖子列表
  • post_id: 帖子ID
  • post_url: 帖子URL
  • author_name: 作者名称
  • author_channel_id: 作者频道ID
  • author_url: 作者频道URL
  • author_thumbnails: 作者头像缩略图
  • content_text: 帖子文本内容
  • published_time: 发布时间（相对时间）
  • vote_count: 点赞数
  • comment_count: 评论数
  • attachment: 附件（图片/多图/视频/投票等，可能为null）
• continuation_token: 下一页分页token
• has_more: 是否还有更多帖子
• total_count: 当前页帖子数量

当 need_format=false 时:

• 返回原始响应数据

使用流程:

1. 首次请求：只传 channel_id 参数
2. 获取响应中的 continuation_token
3. 下次请求：传入 channel_id 和 continuation_token
4. 重复步骤 2-3 直到 has_more 为 false

注意事项:

• 每页通常返回 20 个左右的帖子
• 帖子附件支持: 图片、多图、视频、投票等类型
• 部分频道可能没有帖子/社区标签页

价格:

• $0.001 USD / 请求

[English]

Purpose:

• Get YouTube channel's community posts list
• Supports pagination via continuation_token

Parameters:

Required:

channel_id (string)

• Purpose: Channel ID
• How to get: Extract from channel URL, e.g., https://www.youtube.com/channel/UCkRfArvrzheW2E7b6SVT7vQ
• Example: "UCkRfArvrzheW2E7b6SVT7vQ"

Optional:

language_code (string, optional) - Language code, default "zh-CN"

country_code (string, optional) - Country code, default "US"

continuation_token (string, optional) - Pagination token for next page

need_format (bool, optional) - Whether to format data, default true

Returns:

When need_format=true:

• channel_id: Channel ID
• posts: Posts list
  • post_id: Post ID
  • post_url: Post URL
  • author_name: Author name
  • author_channel_id: Author channel ID
  • author_url: Author channel URL
  • author_thumbnails: Author avatar thumbnails
  • content_text: Post text content
  • published_time: Published time (relative)
  • vote_count: Like count
  • comment_count: Comment count
  • attachment: Attachment (image/multi_image/video/poll, may be null)
• continuation_token: Next page pagination token
• has_more: Whether there are more posts
• total_count: Current page post count

When need_format=false:

• Returns raw response data

Usage Flow:

1. First request: Only pass channel_id parameter
2. Get continuation_token from response
3. Next request: Pass channel_id and continuation_token
4. Repeat steps 2-3 until has_more is false

Notes:

• Each page typically returns around 20 posts
• Post attachments support: image, multi_image, video, poll types
• Some channels may not have posts/community tab

Price:

• $0.001 USD / request

[示例/Example]

获取频道帖子: channel_id = "UCkRfArvrzheW2E7b6SVT7vQ"

Imported from a validated TikHub OpenAPI document. Pricing must be reviewed before enabling.