搜索频道/Search channels

[中文]

用途:

• 搜索YouTube频道
• 只返回频道类型的搜索结果（过滤掉视频、播放列表等）
• 支持分页获取更多频道

参数:

• keyword: 搜索关键词（首次请求必填）
• continuation_token: 分页token（可选，用于获取下一页）
• need_format: 是否格式化数据（默认 true）
  • true: 返回格式化的结构化数据（推荐）
  • false: 返回原始的 YouTube API 结构（用于调试）

返回数据包含:

当 need_format=true 时:

• keyword: 搜索关键词
• channels: 频道列表
  • channel_id: 频道ID（如 "UCjuNibFJ21MiSNpu8LZyV4w"）
  • title: 频道名称
  • handle: 频道自定义handle（如 "@chaijing2023"）
  • subscriber_count_text: 订阅者数量文本（如 "1.11M subscribers"）
  • description: 频道描述片段
  • thumbnails: 缩略图列表（包含不同尺寸）
  • is_subscribed: 当前用户是否已订阅该频道（布尔值）
  • canonical_url: 频道规范URL路径（如 "/@chaijing2023"）
  • channel_url: 频道完整URL（优先使用自定义URL）
• continuation_token: 下一页的分页token
• has_more: 是否还有更多频道
• total_count: 当前页频道数量

当 need_format=false 时:

• keyword: 搜索关键词
• channels: 原始的 channelRenderer 对象列表
• continuation_token: 下一页的分页token
• has_more: 是否还有更多频道
• total_count: 当前页频道数量

使用流程:

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

注意事项:

• 每页通常返回 10-20 个频道
• 搜索结果只包含频道，不包含视频、播放列表等
• 搜索结果的顺序和数量由 YouTube 算法决定

价格:

• $0.001 USD / 请求

[English]

Purpose:

• Search YouTube channels
• Only returns channel-type search results (filters out videos, playlists, etc.)
• Supports pagination to get more channels

Parameters:

• keyword: Search keyword (required for first request)
• 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:

• keyword: Search keyword
• channels: Channels list
  • channel_id: Channel ID (e.g., "UCjuNibFJ21MiSNpu8LZyV4w")
  • title: Channel name
  • handle: Channel custom handle (e.g., "@chaijing2023")
  • subscriber_count_text: Subscriber count text (e.g., "1.11M subscribers")
  • description: Channel description snippet
  • thumbnails: Thumbnail list (multiple sizes)
  • is_subscribed: Whether current user is subscribed to this channel (boolean)
  • canonical_url: Channel canonical URL path (e.g., "/@chaijing2023")
  • channel_url: Full channel URL (prefers custom URL)
• continuation_token: Next page pagination token
• has_more: Whether there are more channels
• total_count: Current page channel count

When need_format=false:

• keyword: Search keyword
• channels: Raw channelRenderer object list
• continuation_token: Next page pagination token
• has_more: Whether there are more channels
• total_count: Current page channel count

Usage Flow:

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

Notes:

• Each page typically returns 10-20 channels
• Search results only include channels, not videos, playlists, etc.
• Order and quantity of results determined by YouTube algorithm

Price:

• $0.001 USD / request

[示例/Example]

搜索频道: keyword = "Rick Astley"

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