[中文]

用途:

• 获取YouTube频道的介绍信息（订阅数、视频数、观看次数、注册时间、社交链接等）

重要提示 - 需要两次请求获取完整数据:

• 第一次请求（使用channel_id）: 返回基本信息（频道名称、描述、订阅数、视频数、头像、横幅等）
• 第二次请求（使用continuation_token）: 返回高级信息（注册时间、社交媒体链接、国家、观看次数等）

如何获取channel_id:

• 如果你只有频道URL（如 https://www.youtube.com/@CozyCraftYT），请先调用 get_channel_id 接口获取channel_id
• 该接口会返回类似 UCeu6U67OzJhV1KwBansH3Dg 的频道ID

参数详解:

📌 必选参数（二选一）:

channel_id (string)

• 作用: 频道ID，用于第一次请求获取频道基本信息
• 格式: 通常以 UC 开头的24位字符串
• 示例: "UCeu6U67OzJhV1KwBansH3Dg"
• 获取方式: 调用 get_channel_id 接口，传入频道URL即可获取

continuation_token (string)

• 作用: 翻页标志，用于第二次请求获取频道的高级信息
• 获取方式: 从第一次请求的响应中获取 continuation_token 字段
• 注意: channel_id 和 continuation_token 必须提供其中一个

⚙️ 可选参数:

language_code (string, 可选)

• 作用: 设置显示语言偏好
• 默认值: "zh-CN"
• 可用值: "zh-CN", "en-US", "ja-JP", "ko-KR" 等

country_code (string, 可选)

• 作用: 设置地区代码
• 默认值: "US"
• 可用值: "US", "JP", "GB" 等

need_format (boolean, 可选)

• 作用: 是否返回清洗后的精简数据
• 默认值: true
• 可用值:
  • false - 返回原始完整数据
  • true - 返回清洗后的精简数据（推荐，默认）

使用流程（三步获取完整数据）:

1. 获取channel_id: 如果只有频道URL，先调用 get_channel_id?channel_url=https://www.youtube.com/@CozyCraftYT
2. 第一次请求: 使用 channel_id 参数获取频道基本信息，同时获取 continuation_token
3. 第二次请求: 使用 continuation_token 获取高级信息（注册时间、社交链接等）

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

第一次请求返回（使用channel_id）:

{
  "channel_id": "UCeu6U67OzJhV1KwBansH3Dg",
  "title": "CozyCraft",
  "handle": "CozyCraftYT",
  "description": "频道介绍...",
  "subscriber_count": "9.84万位订阅者",
  "video_count": "181 个视频",
  "view_count": null,
  "country": null,
  "creation_date": null,
  "links": [],
  "avatar": [{"url": "...", "width": 900, "height": 900}],
  "banner": [{"url": "...", "width": 2560, "height": 424}],
  "keywords": "Minecraft Ambience...",
  "channel_url": "https://www.youtube.com/channel/UCeu6U67OzJhV1KwBansH3Dg",
  "vanity_url": "http://www.youtube.com/@CozyCraftYT",
  "rss_url": "https://www.youtube.com/feeds/videos.xml?channel_id=UCeu6U67OzJhV1KwBansH3Dg",
  "is_family_safe": true,
  "verified": false,
  "has_business_email": false,
  "has_membership": true,
  "continuation_token": "4qmFsgJg..."
}

第二次请求返回（使用continuation_token）:

{
  "channel_id": "UCeu6U67OzJhV1KwBansH3Dg",
  "title": null,
  "handle": "CozyCraftYT",
  "description": "完整频道介绍...",
  "subscriber_count": "98.4K subscribers",
  "video_count": "181 videos",
  "view_count": "53,218,926 views",
  "country": "United States",
  "creation_date": "Oct 28, 2022",
  "links": [
    {"name": "Discord", "url": "https://discord.gg/tvuxxcsgSS"},
    {"name": "Twitter", "url": "https://twitter.com/..."}
  ],
  "avatar": [],
  "banner": [],
  "verified": false,
  "has_business_email": true,
  "continuation_token": null
}

注意事项:

• 必须进行两次请求才能获取完整的频道信息
• 第一次请求: 获取基本信息（title、avatar、banner、keywords、rss_url等）和 continuation_token
• 第二次请求: 获取高级信息（creation_date、links、view_count、country等）
• 建议两次请求都设置 need_format=true 获取清洗后的数据
• 可以合并两次请求的结果来获得完整的频道信息

[English]

Purpose:

• Get YouTube channel description information (subscribers, videos, views, creation date, social links, etc.)

Important - Two requests required for complete data:

• First request (with channel_id): Returns basic info (title, description, subscribers, videos, avatar, banner, etc.)
• Second request (with continuation_token): Returns advanced info (creation date, social media links, country, view count, etc.)

How to get channel_id:

• If you only have channel URL (e.g., https://www.youtube.com/@CozyCraftYT), call get_channel_id endpoint first
• It will return channel_id like UCeu6U67OzJhV1KwBansH3Dg

Parameters:

📌 Required (choose one):

channel_id (string)

• Purpose: Channel ID for first request to get basic channel info
• Format: Usually starts with UC, 24 characters
• Example: "UCeu6U67OzJhV1KwBansH3Dg"
• How to get: Call get_channel_id endpoint with channel URL

continuation_token (string)

• Purpose: Pagination token for second request to get advanced info
• How to get: Get continuation_token field from first request response
• Note: Must provide either channel_id or continuation_token

⚙️ Optional:

language_code (string, optional)

• Purpose: Set language preference
• 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.

need_format (boolean, optional)

• Purpose: Whether to return cleaned simplified data
• Default: true
• Values:
  • false - Return raw complete data
  • true - Return cleaned simplified data (recommended, default)

Usage Flow (3 steps for complete data):

1. Get channel_id: If you only have URL, call get_channel_id?channel_url=https://www.youtube.com/@CozyCraftYT
2. First request: Use channel_id parameter to get basic info and continuation_token
3. Second request: Use continuation_token to get advanced info (creation date, social links, etc.)

Response Structure (need_format=true):

First request response (with channel_id):

{
  "channel_id": "UCeu6U67OzJhV1KwBansH3Dg",
  "title": "CozyCraft",
  "handle": "CozyCraftYT",
  "description": "Channel description...",
  "subscriber_count": "98.4K subscribers",
  "video_count": "181 videos",
  "view_count": null,
  "country": null,
  "creation_date": null,
  "links": [],
  "avatar": [{"url": "...", "width": 900, "height": 900}],
  "banner": [{"url": "...", "width": 2560, "height": 424}],
  "keywords": "Minecraft Ambience...",
  "channel_url": "https://www.youtube.com/channel/UCeu6U67OzJhV1KwBansH3Dg",
  "vanity_url": "http://www.youtube.com/@CozyCraftYT",
  "rss_url": "https://www.youtube.com/feeds/videos.xml?channel_id=UCeu6U67OzJhV1KwBansH3Dg",
  "is_family_safe": true,
  "verified": false,
  "has_business_email": false,
  "has_membership": true,
  "continuation_token": "4qmFsgJg..."
}

Second request response (with continuation_token):

{
  "channel_id": "UCeu6U67OzJhV1KwBansH3Dg",
  "title": null,
  "handle": "CozyCraftYT",
  "description": "Full channel description...",
  "subscriber_count": "98.4K subscribers",
  "video_count": "181 videos",
  "view_count": "53,218,926 views",
  "country": "United States",
  "creation_date": "Oct 28, 2022",
  "links": [
    {"name": "Discord", "url": "https://discord.gg/tvuxxcsgSS"},
    {"name": "Twitter", "url": "https://twitter.com/..."}
  ],
  "avatar": [],
  "banner": [],
  "verified": false,
  "has_business_email": true,
  "continuation_token": null
}

Notes:

• Two requests are required to get complete channel information
• First request: Get basic info (title, avatar, banner, keywords, rss_url, etc.) and continuation_token
• Second request: Get advanced info (creation_date, links, view_count, country, etc.)
• Recommend setting need_format=true for both requests
• You can merge results from both requests for complete channel info

[示例/Examples]

步骤1 - 获取channel_id（如果只有URL）

GET /youtube_web/get_channel_id?channel_url=https://www.youtube.com/@CozyCraftYT

步骤2 - 第一次请求获取基本信息和continuation_token

GET /youtube_web/get_channel_description?channel_id=UCeu6U67OzJhV1KwBansH3Dg&need_format=true

步骤3 - 第二次请求获取高级信息（使用返回的continuation_token）

GET /youtube_web/get_channel_description?continuation_token=xxx&need_format=true