获取频道短视频列表/Get channel shorts

[中文]

用途:

• 获取YouTube频道的短视频(Shorts)列表
• 支持分页获取更多短视频

参数:

• channel_id: 频道ID（推荐，如 UCuAXFkgsw1L7xaCfnd5JJOw）
• channel_url: 频道URL（可选，如果提供channel_id则忽略）
• continuation_token: 分页token（可选，用于获取下一页）
• need_format: 是否格式化数据（默认 true）
  • true: 返回格式化的结构化数据（推荐）
  • false: 返回原始的 YouTube API 结构（用于调试）

返回数据包含:

当 need_format=true 时:

• channel_id: 频道ID
• shorts: 短视频列表
  • video_id: 短视频的ID
  • title: 标题
  • view_count_text: 观看次数文本（如 "1.2M views"）
  • thumbnails: 缩略图列表
  • accessibility_text: 无障碍文本描述
  • video_url: 短视频链接
• continuation_token: 下一页的分页token
• has_more: 是否还有更多短视频
• total_count: 当前页短视频数量

当 need_format=false 时:

• channel_id: 频道ID
• shorts: 原始的 reelItemRenderer 对象列表
• continuation_token: 下一页的分页token
• has_more: 是否还有更多短视频
• total_count: 当前页短视频数量

使用流程:

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

注意事项:

• 每页通常返回 30 个左右的短视频
• ⚠️ 目前暂不支持 @username 格式，请使用频道ID（UCxxxx 格式）

价格:

• $0.001 USD / 请求

[English]

Purpose:

• Get YouTube channel's Shorts (short videos) list
• Supports pagination to get more shorts

Parameters:

• channel_id: Channel ID (recommended, e.g., UCuAXFkgsw1L7xaCfnd5JJOw)
• channel_url: Channel URL (optional, ignored if channel_id is provided)
• continuation_token: Pagination token (optional, for next page)
• need_format: Whether to format data (default true)
  • true: Return formatted structured data (recommended)
  • false: Return raw YouTube API structure (for debugging)

Returns:

When need_format=true:

• channel_id: Channel ID
• shorts: Shorts list
  • video_id: Short video ID
  • title: Title
  • view_count_text: View count text (e.g., "1.2M views")
  • thumbnails: Thumbnail list
  • accessibility_text: Accessibility description text
  • video_url: Short video URL
• continuation_token: Next page pagination token
• has_more: Whether there are more shorts
• total_count: Current page shorts count

When need_format=false:

• channel_id: Channel ID
• shorts: Raw reelItemRenderer object list
• continuation_token: Next page pagination token
• has_more: Whether there are more shorts
• total_count: Current page shorts count

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 30 shorts
• ⚠️ Currently does not support @username format, please use channel ID (UCxxxx format)

Price:

• $0.001 USD / request

[示例/Example]

获取短视频列表: channel_id = "UCuAXFkgsw1L7xaCfnd5JJOw"

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