@tikomni/skills 0.1.0

package/skills/creator-analysis/references/api-contracts/youtube-web-api.md

@@ -0,0 +1,2636 @@
+# YouTube-Web-API Full Contract
+
+- Back to index: [`api-capability-index.md`](../api-capability-index.md)
+- Back to route summary: [`api-tags/youtube-web-api.md`](../api-tags/youtube-web-api.md)
+- Current contract file: `api-contracts/youtube-web-api.md`
+- Source: `https://app.tikomni.com/openapi/tikomni-openapi.full.with-u2.public.latest.json`
+- Fetched at: `2026-03-08T06:54:04+00:00`
+- Route count: `21`
+- Default auth: Header `Authorization` Bearer
+- Read this file only when you need precise auth notes, parameter descriptions, defaults, examples, or success-response fields.
+- Tag description: **(YouTube Web数据接口/YouTube-Web-API endpoints)**
+
+## Route Contracts
+
+<a id="get-api-u1-v1-youtube-web-get-channel-description"></a>
+### `GET /api/u1/v1/youtube/web/get_channel_description`
+
+- Summary: 获取频道描述信息/Get channel description
+- Capabilities: profiles / accounts
+- Auth: Header `Authorization: Bearer {token}`; docs also allow Cookie `Authorization` as fallback (`HTTPBearer`)
+- operationId: `get_channel_description_api_v1_youtube_web_get_channel_description_get`
+
+#### Notes
+
+> # [中文]
+> ### 用途:
+> - 获取YouTube频道的介绍信息（订阅数、视频数、观看次数、注册时间、社交链接等）
+>
+> ### 重要提示 - 需要两次请求获取完整数据:
+> - **第一次请求**（使用channel_id）: 返回基本信息（频道名称、描述、订阅数、视频数、头像、横幅等）
+> - **第二次请求**（使用continuation_token）: 返回高级信息（**注册时间、社交媒体链接、国家、观看次数**等）
+>
+> ### 如何获取channel_id:
+> - 如果你只有频道URL（如 `https://www.youtube.com/@CozyCraftYT`），请先调用 **get_channel_id_v2** 接口获取channel_id
+> - 该接口会返回类似 `UCeu6U67OzJhV1KwBansH3Dg` 的频道ID
+>
+> ### 参数详解:
+>
+> #### 📌 必选参数（二选一）:
+> **channel_id** (string)
+> - **作用**: 频道ID，用于第一次请求获取频道基本信息
+> - **格式**: 通常以 `UC` 开头的24位字符串
+> - **示例**: `"UCeu6U67OzJhV1KwBansH3Dg"`
+> - **获取方式**: 调用 **get_channel_id_v2** 接口，传入频道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, 可选)
+> - **作用**: 是否返回清洗后的精简数据
+> - **默认值**: `false`
+> - **可用值**:
+>   - `false` - 返回原始完整数据
+>   - `true` - 返回清洗后的精简数据（推荐）
+>
+> ### 使用流程（三步获取完整数据）:
+> 1. **获取channel_id**: 如果只有频道URL，先调用 `get_channel_id_v2?channel_url=https://www.youtube.com/@CozyCraftYT`
+> 2. **第一次请求**: 使用 `channel_id` 参数获取频道基本信息，同时获取 `continuation_token`
+> 3. **第二次请求**: 使用 `continuation_token` 获取高级信息（注册时间、社交链接等）
+>
+> ### 返回数据结构 (need_format=true):
+>
+> #### 第一次请求返回（使用channel_id）:
+> ```json
+> {
+>   "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）:
+> ```json
+> {
+>   "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_v2** 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_v2** 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**: `false`
+> - **Values**:
+>   - `false` - Return raw complete data
+>   - `true` - Return cleaned simplified data (recommended)
+>
+> ### Usage Flow (3 steps for complete data):
+> 1. **Get channel_id**: If you only have URL, call `get_channel_id_v2?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):
+> ```json
+> {
+>   "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):
+> ```json
+> {
+>   "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_v2?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
+
+#### Parameters
+
+| Field | In | Type | Required | Description | Default | Example | Enum |
+| --- | --- | --- | --- | --- | --- | --- | --- |
+| channel_id | query | string | No | 频道ID（格式如：UCeu6U67OzJhV1KwBansH3Dg），可通过get_channel_id_v2接口从频道URL获取/Channel ID, can be obtained from channel URL via get_channel_id_v2 endpoint | None | UCeu6U67OzJhV1KwBansH3Dg | None |
+| continuation_token | query | string | No | 翻页标志（用于获取频道注册时间等高级信息）/Continuation token for getting advanced info like channel creation date | None | None | None |
+| language_code | query | string | No | 语言代码（如zh-CN, en-US等）/Language code | zh-CN | zh-CN | None |
+| country_code | query | string | No | 国家代码（如US, JP等）/Country code | US | US | None |
+| need_format | query | boolean | No | 是否需要清洗数据，提取关键内容，移除冗余数据/Whether to clean and format the data | false | None | None |
+
+#### Request Body
+
+None
+
+#### Success Response
+
+##### `200 application/json`
+
+- Schema summary: `code`:integer, `request_id`:string, `message`:string, `message_zh`:string, `support`:string, `time`:string, `time_stamp`:integer, `time_zone`:string, ...
+
+| Field | Type | Required | Description | Default | Example | Enum |
+| --- | --- | --- | --- | --- | --- | --- |
+| code | integer | No | HTTP status code \| HTTP状态码 | 200 | None | None |
+| request_id | string | No | Unique request identifier \| 唯一请求标识符 | None | None | None |
+| message | string | No | Response message (EN-US) \| 响应消息 (English) | Request successful. This request will incur a charge. | None | None |
+| message_zh | string | No | Response message (ZH-CN) \| 响应消息 (中文) | 请求成功，本次请求将被计费。 | None | None |
+| support | string | No | Support message \| 支持消息 | Discord: https://discord.gg/aMEAS8Xsvz | None | None |
+| time | string | No | The time the response was generated \| 生成响应的时间 | None | None | None |
+| time_stamp | integer | No | The timestamp the response was generated \| 生成响应的时间戳 | None | None | None |
+| time_zone | string | No | The timezone of the response time \| 响应时间的时区 | America/Los_Angeles | None | None |
+| docs | string | No | Link to the API Swagger documentation for this endpoint \| 此端点的 API Swagger 文档链接 | None | None | None |
+| cache_message | string | No | Cache message (EN-US) \| 缓存消息 (English) | This request will be cached. You can access the cached result directly using th… | None | None |
+| cache_message_zh | string | No | Cache message (ZH-CN) \| 缓存消息 (中文) | 本次请求将被缓存，你可以使用下面的 URL 直接访问缓存结果，有效期为 24 小时，访问缓存不会产生额外费用。 | None | None |
+| cache_url | string | No | The URL to access the cached result \| 访问缓存结果的 URL | None | None | None |
+| router | string | No | The endpoint that generated this response \| 生成此响应的端点 | None | None | None |
+| params | dynamic object | No | The parameters used in the request \| 请求中使用的参数 | None | None | None |
+| data | null | No | The response data \| 响应数据 | None | None | None |
+
+<a id="get-api-u1-v1-youtube-web-get-channel-id"></a>
+### `GET /api/u1/v1/youtube/web/get_channel_id`
+
+- Summary: 获取频道ID/Get channel ID
+- Capabilities: profiles / accounts
+- Auth: Header `Authorization: Bearer {token}`; docs also allow Cookie `Authorization` as fallback (`HTTPBearer`)
+- operationId: `get_channel_id_api_v1_youtube_web_get_channel_id_get`
+
+#### Notes
+
+> # [中文]
+> ### 用途:
+> - 获取频道ID。
+> ### 参数:
+> - channel_name: 频道名称。
+> ### 返回:
+> - 频道ID。
+>
+> # [English]
+> ### Purpose:
+> - Get channel ID.
+> ### Parameters:
+> - channel_name: Channel name.
+> ### Returns:
+> - Channel ID.
+>
+> # [示例/Example]
+> channel_name = "LinusTechTips"
+
+#### Parameters
+
+| Field | In | Type | Required | Description | Default | Example | Enum |
+| --- | --- | --- | --- | --- | --- | --- | --- |
+| channel_name | query | string | Yes | 频道名称/Channel name | None | LinusTechTips | None |
+
+#### Request Body
+
+None
+
+#### Success Response
+
+##### `200 application/json`
+
+- Schema summary: `code`:integer, `request_id`:string, `message`:string, `message_zh`:string, `support`:string, `time`:string, `time_stamp`:integer, `time_zone`:string, ...
+
+| Field | Type | Required | Description | Default | Example | Enum |
+| --- | --- | --- | --- | --- | --- | --- |
+| code | integer | No | HTTP status code \| HTTP状态码 | 200 | None | None |
+| request_id | string | No | Unique request identifier \| 唯一请求标识符 | None | None | None |
+| message | string | No | Response message (EN-US) \| 响应消息 (English) | Request successful. This request will incur a charge. | None | None |
+| message_zh | string | No | Response message (ZH-CN) \| 响应消息 (中文) | 请求成功，本次请求将被计费。 | None | None |
+| support | string | No | Support message \| 支持消息 | Discord: https://discord.gg/aMEAS8Xsvz | None | None |
+| time | string | No | The time the response was generated \| 生成响应的时间 | None | None | None |
+| time_stamp | integer | No | The timestamp the response was generated \| 生成响应的时间戳 | None | None | None |
+| time_zone | string | No | The timezone of the response time \| 响应时间的时区 | America/Los_Angeles | None | None |
+| docs | string | No | Link to the API Swagger documentation for this endpoint \| 此端点的 API Swagger 文档链接 | None | None | None |
+| cache_message | string | No | Cache message (EN-US) \| 缓存消息 (English) | This request will be cached. You can access the cached result directly using th… | None | None |
+| cache_message_zh | string | No | Cache message (ZH-CN) \| 缓存消息 (中文) | 本次请求将被缓存，你可以使用下面的 URL 直接访问缓存结果，有效期为 24 小时，访问缓存不会产生额外费用。 | None | None |
+| cache_url | string | No | The URL to access the cached result \| 访问缓存结果的 URL | None | None | None |
+| router | string | No | The endpoint that generated this response \| 生成此响应的端点 | None | None | None |
+| params | dynamic object | No | The parameters used in the request \| 请求中使用的参数 | None | None | None |
+| data | null | No | The response data \| 响应数据 | None | None | None |
+
+<a id="get-api-u1-v1-youtube-web-get-channel-id-v2"></a>
+### `GET /api/u1/v1/youtube/web/get_channel_id_v2`
+
+- Summary: 从频道URL获取频道ID V2/Get channel ID from URL V2
+- Capabilities: profiles / accounts
+- Auth: Header `Authorization: Bearer {token}`; docs also allow Cookie `Authorization` as fallback (`HTTPBearer`)
+- operationId: `get_channel_id_v2_api_v1_youtube_web_get_channel_id_v2_get`
+
+#### Notes
+
+> # [中文]
+> ### 用途:
+> - 从YouTube频道URL转换获取频道ID（channel_id）。
+> - 支持多种URL格式，包括@用户名格式、/channel/格式、/c/格式、/user/格式。
+> ### 参数:
+> - channel_url: 频道URL。
+> ### 返回:
+> - channel_id: 频道ID（如：UCeu6U67OzJhV1KwBansH3Dg）
+> - channel_url: 标准化的频道URL
+> - source: 数据来源（url_parse表示直接从URL解析，page_parse表示从页面解析）
+>
+> # [English]
+> ### Purpose:
+> - Convert YouTube channel URL to channel ID.
+> - Supports multiple URL formats including @username, /channel/, /c/, /user/ formats.
+> ### Parameters:
+> - channel_url: Channel URL.
+> ### Returns:
+> - channel_id: Channel ID (e.g., UCeu6U67OzJhV1KwBansH3Dg)
+> - channel_url: Normalized channel URL
+> - source: Data source (url_parse means parsed from URL directly, page_parse means parsed from page)
+>
+> # [示例/Example]
+> channel_url = "https://www.youtube.com/@CozyCraftYT"
+
+#### Parameters
+
+| Field | In | Type | Required | Description | Default | Example | Enum |
+| --- | --- | --- | --- | --- | --- | --- | --- |
+| channel_url | query | string | Yes | 频道URL/Channel URL，支持多种格式如：https://www.youtube.com/@username, https://www.youtube.com/channel/UCxxxxxx, https://www.youtube.com/c/channelname | None | https://www.youtube.com/@CozyCraftYT | None |
+
+#### Request Body
+
+None
+
+#### Success Response
+
+##### `200 application/json`
+
+- Schema summary: `code`:integer, `request_id`:string, `message`:string, `message_zh`:string, `support`:string, `time`:string, `time_stamp`:integer, `time_zone`:string, ...
+
+| Field | Type | Required | Description | Default | Example | Enum |
+| --- | --- | --- | --- | --- | --- | --- |
+| code | integer | No | HTTP status code \| HTTP状态码 | 200 | None | None |
+| request_id | string | No | Unique request identifier \| 唯一请求标识符 | None | None | None |
+| message | string | No | Response message (EN-US) \| 响应消息 (English) | Request successful. This request will incur a charge. | None | None |
+| message_zh | string | No | Response message (ZH-CN) \| 响应消息 (中文) | 请求成功，本次请求将被计费。 | None | None |
+| support | string | No | Support message \| 支持消息 | Discord: https://discord.gg/aMEAS8Xsvz | None | None |
+| time | string | No | The time the response was generated \| 生成响应的时间 | None | None | None |
+| time_stamp | integer | No | The timestamp the response was generated \| 生成响应的时间戳 | None | None | None |
+| time_zone | string | No | The timezone of the response time \| 响应时间的时区 | America/Los_Angeles | None | None |
+| docs | string | No | Link to the API Swagger documentation for this endpoint \| 此端点的 API Swagger 文档链接 | None | None | None |
+| cache_message | string | No | Cache message (EN-US) \| 缓存消息 (English) | This request will be cached. You can access the cached result directly using th… | None | None |
+| cache_message_zh | string | No | Cache message (ZH-CN) \| 缓存消息 (中文) | 本次请求将被缓存，你可以使用下面的 URL 直接访问缓存结果，有效期为 24 小时，访问缓存不会产生额外费用。 | None | None |
+| cache_url | string | No | The URL to access the cached result \| 访问缓存结果的 URL | None | None | None |
+| router | string | No | The endpoint that generated this response \| 生成此响应的端点 | None | None | None |
+| params | dynamic object | No | The parameters used in the request \| 请求中使用的参数 | None | None | None |
+| data | null | No | The response data \| 响应数据 | None | None | None |
+
+<a id="get-api-u1-v1-youtube-web-get-channel-info"></a>
+### `GET /api/u1/v1/youtube/web/get_channel_info`
+
+- Summary: 获取频道信息/Get channel information
+- Capabilities: profiles / accounts
+- Auth: Header `Authorization: Bearer {token}`; docs also allow Cookie `Authorization` as fallback (`HTTPBearer`)
+- operationId: `get_channel_info_api_v1_youtube_web_get_channel_info_get`
+
+#### Notes
+
+> # [中文]
+> ### 用途:
+> - 获取频道信息。
+> ### 参数:
+> - channel_id: 频道ID。
+> ### 返回:
+> - 频道信息。
+>
+> # [English]
+> ### Purpose:
+> - Get channel information.
+> ### Parameters:
+> - channel_id: Channel ID.
+> ### Returns:
+> - Channel information.
+>
+> # [示例/Example]
+> channel_id = "UCXuqSBlHAE6Xw-yeJA0Tunw"
+
+#### Parameters
+
+| Field | In | Type | Required | Description | Default | Example | Enum |
+| --- | --- | --- | --- | --- | --- | --- | --- |
+| channel_id | query | string | Yes | 频道ID/Channel ID | None | UCXuqSBlHAE6Xw-yeJA0Tunw | None |
+
+#### Request Body
+
+None
+
+#### Success Response
+
+##### `200 application/json`
+
+- Schema summary: `code`:integer, `request_id`:string, `message`:string, `message_zh`:string, `support`:string, `time`:string, `time_stamp`:integer, `time_zone`:string, ...
+
+| Field | Type | Required | Description | Default | Example | Enum |
+| --- | --- | --- | --- | --- | --- | --- |
+| code | integer | No | HTTP status code \| HTTP状态码 | 200 | None | None |
+| request_id | string | No | Unique request identifier \| 唯一请求标识符 | None | None | None |
+| message | string | No | Response message (EN-US) \| 响应消息 (English) | Request successful. This request will incur a charge. | None | None |
+| message_zh | string | No | Response message (ZH-CN) \| 响应消息 (中文) | 请求成功，本次请求将被计费。 | None | None |
+| support | string | No | Support message \| 支持消息 | Discord: https://discord.gg/aMEAS8Xsvz | None | None |
+| time | string | No | The time the response was generated \| 生成响应的时间 | None | None | None |
+| time_stamp | integer | No | The timestamp the response was generated \| 生成响应的时间戳 | None | None | None |
+| time_zone | string | No | The timezone of the response time \| 响应时间的时区 | America/Los_Angeles | None | None |
+| docs | string | No | Link to the API Swagger documentation for this endpoint \| 此端点的 API Swagger 文档链接 | None | None | None |
+| cache_message | string | No | Cache message (EN-US) \| 缓存消息 (English) | This request will be cached. You can access the cached result directly using th… | None | None |
+| cache_message_zh | string | No | Cache message (ZH-CN) \| 缓存消息 (中文) | 本次请求将被缓存，你可以使用下面的 URL 直接访问缓存结果，有效期为 24 小时，访问缓存不会产生额外费用。 | None | None |
+| cache_url | string | No | The URL to access the cached result \| 访问缓存结果的 URL | None | None | None |
+| router | string | No | The endpoint that generated this response \| 生成此响应的端点 | None | None | None |
+| params | dynamic object | No | The parameters used in the request \| 请求中使用的参数 | None | None | None |
+| data | null | No | The response data \| 响应数据 | None | None | None |
+
+<a id="get-api-u1-v1-youtube-web-get-channel-short-videos"></a>
+### `GET /api/u1/v1/youtube/web/get_channel_short_videos`
+
+- Summary: 获取频道短视频/Get channel short videos
+- Capabilities: profiles / accounts / content details
+- Auth: Header `Authorization: Bearer {token}`; docs also allow Cookie `Authorization` as fallback (`HTTPBearer`)
+- operationId: `get_channel_short_videos_api_v1_youtube_web_get_channel_short_videos_get`
+
+#### Notes
+
+> # [中文]
+> ### 用途:
+> - 获取频道短视频。
+> ### 参数:
+> - channel_id: 频道ID。
+> - continuation_token: 用于继续获取频道短视频的令牌。默认为None。
+> ### 返回:
+> - 频道短视频。
+>
+> # [English]
+> ### Purpose:
+> - Get channel short videos.
+> ### Parameters:
+> - channel_id: Channel ID.
+> - continuation_token: Token to continue fetching channel short videos. Default is None.
+> ### Returns:
+> - Channel short videos.
+>
+> # [示例/Example]
+> channel_id = "UCXuqSBlHAE6Xw-yeJA0Tunw"
+
+#### Parameters
+
+| Field | In | Type | Required | Description | Default | Example | Enum |
+| --- | --- | --- | --- | --- | --- | --- | --- |
+| channel_id | query | string | Yes | 频道ID/Channel ID | None | UCXuqSBlHAE6Xw-yeJA0Tunw | None |
+| continuation_token | query | string | No | 翻页令牌/Pagination token | None | None | None |
+
+#### Request Body
+
+None
+
+#### Success Response
+
+##### `200 application/json`
+
+- Schema summary: `code`:integer, `request_id`:string, `message`:string, `message_zh`:string, `support`:string, `time`:string, `time_stamp`:integer, `time_zone`:string, ...
+
+| Field | Type | Required | Description | Default | Example | Enum |
+| --- | --- | --- | --- | --- | --- | --- |
+| code | integer | No | HTTP status code \| HTTP状态码 | 200 | None | None |
+| request_id | string | No | Unique request identifier \| 唯一请求标识符 | None | None | None |
+| message | string | No | Response message (EN-US) \| 响应消息 (English) | Request successful. This request will incur a charge. | None | None |
+| message_zh | string | No | Response message (ZH-CN) \| 响应消息 (中文) | 请求成功，本次请求将被计费。 | None | None |
+| support | string | No | Support message \| 支持消息 | Discord: https://discord.gg/aMEAS8Xsvz | None | None |
+| time | string | No | The time the response was generated \| 生成响应的时间 | None | None | None |
+| time_stamp | integer | No | The timestamp the response was generated \| 生成响应的时间戳 | None | None | None |
+| time_zone | string | No | The timezone of the response time \| 响应时间的时区 | America/Los_Angeles | None | None |
+| docs | string | No | Link to the API Swagger documentation for this endpoint \| 此端点的 API Swagger 文档链接 | None | None | None |
+| cache_message | string | No | Cache message (EN-US) \| 缓存消息 (English) | This request will be cached. You can access the cached result directly using th… | None | None |
+| cache_message_zh | string | No | Cache message (ZH-CN) \| 缓存消息 (中文) | 本次请求将被缓存，你可以使用下面的 URL 直接访问缓存结果，有效期为 24 小时，访问缓存不会产生额外费用。 | None | None |
+| cache_url | string | No | The URL to access the cached result \| 访问缓存结果的 URL | None | None | None |
+| router | string | No | The endpoint that generated this response \| 生成此响应的端点 | None | None | None |
+| params | dynamic object | No | The parameters used in the request \| 请求中使用的参数 | None | None | None |
+| data | null | No | The response data \| 响应数据 | None | None | None |
+
+<a id="get-api-u1-v1-youtube-web-get-channel-url"></a>
+### `GET /api/u1/v1/youtube/web/get_channel_url`
+
+- Summary: 从频道ID获取频道URL/Get channel URL from channel ID
+- Capabilities: profiles / accounts
+- Auth: Header `Authorization: Bearer {token}`; docs also allow Cookie `Authorization` as fallback (`HTTPBearer`)
+- operationId: `get_channel_url_api_v1_youtube_web_get_channel_url_get`
+
+#### Notes
+
+> # [中文]
+> ### 用途:
+> - 从YouTube频道ID转换获取频道Handle (@用户名)
+> - 与 get_channel_id_v2 接口互为反向操作
+>
+> ### 参数:
+> - channel_id: 频道ID（如：UCeu6U67OzJhV1KwBansH3Dg）
+>
+> ### 返回:
+> - channel_id: 频道ID
+> - handle: 频道Handle（如：CozyCraftYT）
+> - title: 频道名称
+> - channel_url: 标准频道URL（/channel/格式）
+> - vanity_url: 个性化URL（/@用户名格式）
+>
+> ### 使用场景:
+> - 当你有频道ID但需要获取@用户名格式的URL时
+> - 需要展示用户友好的频道链接时
+>
+> # [English]
+> ### Purpose:
+> - Convert YouTube channel ID to channel handle (@username)
+> - Reverse operation of get_channel_id_v2 endpoint
+>
+> ### Parameters:
+> - channel_id: Channel ID (e.g., UCeu6U67OzJhV1KwBansH3Dg)
+>
+> ### Returns:
+> - channel_id: Channel ID
+> - handle: Channel handle (e.g., CozyCraftYT)
+> - title: Channel name
+> - channel_url: Standard channel URL (/channel/ format)
+> - vanity_url: Vanity URL (/@username format)
+>
+> ### Use Cases:
+> - When you have channel ID but need @username format URL
+> - When you need to display user-friendly channel links
+>
+> # [示例/Example]
+> channel_id = "UCeu6U67OzJhV1KwBansH3Dg"
+
+#### Parameters
+
+| Field | In | Type | Required | Description | Default | Example | Enum |
+| --- | --- | --- | --- | --- | --- | --- | --- |
+| channel_id | query | string | Yes | 频道ID/Channel ID (格式如：UCeu6U67OzJhV1KwBansH3Dg) | None | UCeu6U67OzJhV1KwBansH3Dg | None |
+
+#### Request Body
+
+None
+
+#### Success Response
+
+##### `200 application/json`
+
+- Schema summary: `code`:integer, `request_id`:string, `message`:string, `message_zh`:string, `support`:string, `time`:string, `time_stamp`:integer, `time_zone`:string, ...
+
+| Field | Type | Required | Description | Default | Example | Enum |
+| --- | --- | --- | --- | --- | --- | --- |
+| code | integer | No | HTTP status code \| HTTP状态码 | 200 | None | None |
+| request_id | string | No | Unique request identifier \| 唯一请求标识符 | None | None | None |
+| message | string | No | Response message (EN-US) \| 响应消息 (English) | Request successful. This request will incur a charge. | None | None |
+| message_zh | string | No | Response message (ZH-CN) \| 响应消息 (中文) | 请求成功，本次请求将被计费。 | None | None |
+| support | string | No | Support message \| 支持消息 | Discord: https://discord.gg/aMEAS8Xsvz | None | None |
+| time | string | No | The time the response was generated \| 生成响应的时间 | None | None | None |
+| time_stamp | integer | No | The timestamp the response was generated \| 生成响应的时间戳 | None | None | None |
+| time_zone | string | No | The timezone of the response time \| 响应时间的时区 | America/Los_Angeles | None | None |
+| docs | string | No | Link to the API Swagger documentation for this endpoint \| 此端点的 API Swagger 文档链接 | None | None | None |
+| cache_message | string | No | Cache message (EN-US) \| 缓存消息 (English) | This request will be cached. You can access the cached result directly using th… | None | None |
+| cache_message_zh | string | No | Cache message (ZH-CN) \| 缓存消息 (中文) | 本次请求将被缓存，你可以使用下面的 URL 直接访问缓存结果，有效期为 24 小时，访问缓存不会产生额外费用。 | None | None |
+| cache_url | string | No | The URL to access the cached result \| 访问缓存结果的 URL | None | None | None |
+| router | string | No | The endpoint that generated this response \| 生成此响应的端点 | None | None | None |
+| params | dynamic object | No | The parameters used in the request \| 请求中使用的参数 | None | None | None |
+| data | null | No | The response data \| 响应数据 | None | None | None |
+
+<a id="get-api-u1-v1-youtube-web-get-channel-videos"></a>
+### `GET /api/u1/v1/youtube/web/get_channel_videos`
+
+- Summary: 获取频道视频 V1（即将过时，优先使用 V2）/Get channel videos V1 (deprecated soon, use V2 first)
+- Capabilities: profiles / accounts / content details
+- Auth: Header `Authorization: Bearer {token}`; docs also allow Cookie `Authorization` as fallback (`HTTPBearer`)
+- operationId: `get_channel_videos_api_v1_youtube_web_get_channel_videos_get`
+
+#### Notes
+
+> # [中文]
+> ### 用途:
+> - 获取频道视频。
+> ### 参数:
+> - channel_id: 频道ID。
+> - continuation_token: 用于继续获取频道视频的令牌。默认为None。
+> ### 返回:
+> - 频道视频。
+>
+> # [English]
+> ### Purpose:
+> - Get channel videos.
+> ### Parameters:
+> - channel_id: Channel ID.
+> - continuation_token: Token to continue fetching channel videos. Default is None.
+> ### Returns:
+> - Channel videos.
+>
+> # [示例/Example]
+> channel_id = "UCXuqSBlHAE6Xw-yeJA0Tunw"
+
+#### Parameters
+
+| Field | In | Type | Required | Description | Default | Example | Enum |
+| --- | --- | --- | --- | --- | --- | --- | --- |
+| channel_id | query | string | Yes | 频道ID/Channel ID | None | UCXuqSBlHAE6Xw-yeJA0Tunw | None |
+| continuation_token | query | string | No | 翻页令牌/Pagination token | None | None | None |
+
+#### Request Body
+
+None
+
+#### Success Response
+
+##### `200 application/json`
+
+- Schema summary: `code`:integer, `request_id`:string, `message`:string, `message_zh`:string, `support`:string, `time`:string, `time_stamp`:integer, `time_zone`:string, ...
+
+| Field | Type | Required | Description | Default | Example | Enum |
+| --- | --- | --- | --- | --- | --- | --- |
+| code | integer | No | HTTP status code \| HTTP状态码 | 200 | None | None |
+| request_id | string | No | Unique request identifier \| 唯一请求标识符 | None | None | None |
+| message | string | No | Response message (EN-US) \| 响应消息 (English) | Request successful. This request will incur a charge. | None | None |
+| message_zh | string | No | Response message (ZH-CN) \| 响应消息 (中文) | 请求成功，本次请求将被计费。 | None | None |
+| support | string | No | Support message \| 支持消息 | Discord: https://discord.gg/aMEAS8Xsvz | None | None |
+| time | string | No | The time the response was generated \| 生成响应的时间 | None | None | None |
+| time_stamp | integer | No | The timestamp the response was generated \| 生成响应的时间戳 | None | None | None |
+| time_zone | string | No | The timezone of the response time \| 响应时间的时区 | America/Los_Angeles | None | None |
+| docs | string | No | Link to the API Swagger documentation for this endpoint \| 此端点的 API Swagger 文档链接 | None | None | None |
+| cache_message | string | No | Cache message (EN-US) \| 缓存消息 (English) | This request will be cached. You can access the cached result directly using th… | None | None |
+| cache_message_zh | string | No | Cache message (ZH-CN) \| 缓存消息 (中文) | 本次请求将被缓存，你可以使用下面的 URL 直接访问缓存结果，有效期为 24 小时，访问缓存不会产生额外费用。 | None | None |
+| cache_url | string | No | The URL to access the cached result \| 访问缓存结果的 URL | None | None | None |
+| router | string | No | The endpoint that generated this response \| 生成此响应的端点 | None | None | None |
+| params | dynamic object | No | The parameters used in the request \| 请求中使用的参数 | None | None | None |
+| data | null | No | The response data \| 响应数据 | None | None | None |
+
+<a id="get-api-u1-v1-youtube-web-get-channel-videos-v2"></a>
+### `GET /api/u1/v1/youtube/web/get_channel_videos_v2`
+
+- Summary: 获取频道视频 V2/Get channel videos V2
+- Capabilities: profiles / accounts / content details
+- Auth: Header `Authorization: Bearer {token}`; docs also allow Cookie `Authorization` as fallback (`HTTPBearer`)
+- operationId: `get_channel_videos_v2_api_v1_youtube_web_get_channel_videos_v2_get`
+
+#### Notes
+
+> # [中文]
+>
+> ### 用途:
+> - 获取频道视频 V2，支持获取频道视频列表，频道短视频列表，频道直播列表。
+>
+> ### 参数:
+> - channel_id: 频道ID或频道名称，如果是频道名称，则需要在前面加上 `@` 符号，例如：@LinusTechTips。
+> - lang: 视频结果语言代码，默认为 `en-US`，任何语言代码均可，当提交不支持的语言代码时，默认使用 `en-US` 作为语言代码。
+> - sortBy: 排序方式，默认为 `newest`，可选值为 `newest` 和 `oldest` 和 `mostPopular`：
+>     - newest: 按照最新排序，默认值。
+>     - oldest: 按照最旧排序。
+>     - mostPopular: 按照最热排序。
+> - contentType: 内容类型，默认为 `videos`，可选值为 `videos` 和 `shorts` 和 `live`：
+>     - videos: 视频列表，默认值。
+>     - shorts: 短视频列表。
+>     - live: 直播列表。
+> - nextToken: 用于继续获取视频的令牌。可选参数，默认值为空，从第一页开始获取。
+>     - 如果获取第一页，则nextToken参数为None。
+>     - 如果获取第二页，则nextToken参数为第一页请求返回的nextToken。
+>
+> ### 返回:
+> - 频道视频列表，包含视频ID、标题、缩略图、观看次数、点赞次数、评论数、视频时长等信息。
+>
+> # [English]
+>
+> ### Purpose:
+> - Get channel videos V2, support getting channel video list, channel short video list, channel live list.
+>
+> ### Parameters:
+> - channel_id: Channel ID or channel name, if it is a channel name, add `@` symbol in front of it, for example: @LinusTechTips.
+> - lang: Video result language code, default is `en-US`, any language code is supported, when submitting unsupported language code, default use `en-US` as language code.
+> - sortBy: Sort by, default is `newest`, optional values are `newest` and `oldest` and `mostPopular`:
+>     - newest: Sort by newest, default value.
+>     - oldest: Sort by oldest.
+>     - mostPopular: Sort by most popular.
+> - contentType: Content type, default is `videos`, optional values are `videos`
+>     - videos: Video list, default value.
+>     - shorts: Short video list.
+>     - live: Live list.
+> - nextToken: Token to continue fetching videos. Optional parameter, default value is empty, start from the first page.
+>     - If fetching the first page, the nextToken parameter is None.
+>     - If fetching the second page, the nextToken parameter is the nextToken returned by the first page request.
+> ### Returns:
+> - Channel video list, including video ID, title, thumbnail, view count, like count, comment count, video duration and other information.
+>
+> # [示例/Example]
+> channel_id = "UCXuqSBlHAE6Xw-yeJA0Tunw"
+> lang = "en-US"
+> sortBy = "newest"
+> contentType = "videos"
+> nextToken = None
+
+#### Parameters
+
+| Field | In | Type | Required | Description | Default | Example | Enum |
+| --- | --- | --- | --- | --- | --- | --- | --- |
+| channel_id | query | string | Yes | 频道ID/Channel ID | None | UCXuqSBlHAE6Xw-yeJA0Tunw | None |
+| lang | query | string | No | 视频结果语言代码/Video result language code | en-US | en-US | None |
+| sortBy | query | string | No | 排序方式/Sort by | newest | newest | None |
+| contentType | query | string | No | 内容类型/Content type | videos | videos | None |
+| nextToken | query | string | No | 翻页令牌/Pagination token | None | None | None |
+
+#### Request Body
+
+None
+
+#### Success Response
+
+##### `200 application/json`
+
+- Schema summary: `code`:integer, `request_id`:string, `message`:string, `message_zh`:string, `support`:string, `time`:string, `time_stamp`:integer, `time_zone`:string, ...
+
+| Field | Type | Required | Description | Default | Example | Enum |
+| --- | --- | --- | --- | --- | --- | --- |
+| code | integer | No | HTTP status code \| HTTP状态码 | 200 | None | None |
+| request_id | string | No | Unique request identifier \| 唯一请求标识符 | None | None | None |
+| message | string | No | Response message (EN-US) \| 响应消息 (English) | Request successful. This request will incur a charge. | None | None |
+| message_zh | string | No | Response message (ZH-CN) \| 响应消息 (中文) | 请求成功，本次请求将被计费。 | None | None |
+| support | string | No | Support message \| 支持消息 | Discord: https://discord.gg/aMEAS8Xsvz | None | None |
+| time | string | No | The time the response was generated \| 生成响应的时间 | None | None | None |
+| time_stamp | integer | No | The timestamp the response was generated \| 生成响应的时间戳 | None | None | None |
+| time_zone | string | No | The timezone of the response time \| 响应时间的时区 | America/Los_Angeles | None | None |
+| docs | string | No | Link to the API Swagger documentation for this endpoint \| 此端点的 API Swagger 文档链接 | None | None | None |
+| cache_message | string | No | Cache message (EN-US) \| 缓存消息 (English) | This request will be cached. You can access the cached result directly using th… | None | None |
+| cache_message_zh | string | No | Cache message (ZH-CN) \| 缓存消息 (中文) | 本次请求将被缓存，你可以使用下面的 URL 直接访问缓存结果，有效期为 24 小时，访问缓存不会产生额外费用。 | None | None |
+| cache_url | string | No | The URL to access the cached result \| 访问缓存结果的 URL | None | None | None |
+| router | string | No | The endpoint that generated this response \| 生成此响应的端点 | None | None | None |
+| params | dynamic object | No | The parameters used in the request \| 请求中使用的参数 | None | None | None |
+| data | null | No | The response data \| 响应数据 | None | None | None |
+
+<a id="get-api-u1-v1-youtube-web-get-channel-videos-v3"></a>
+### `GET /api/u1/v1/youtube/web/get_channel_videos_v3`
+
+- Summary: 获取频道视频 V3/Get channel videos V3
+- Capabilities: profiles / accounts / content details
+- Auth: Header `Authorization: Bearer {token}`; docs also allow Cookie `Authorization` as fallback (`HTTPBearer`)
+- operationId: `get_channel_videos_v3_api_v1_youtube_web_get_channel_videos_v3_get`
+
+#### Notes
+
+> # [中文]
+> ### 用途:
+> - 获取YouTube频道的视频列表 V3
+> - 支持分页获取，可通过 continuation_token 获取更多视频
+>
+> ### 参数详解:
+>
+> #### 📌 必选参数:
+> **channel_id** (string)
+> - **作用**: 频道ID
+> - **获取方式**:
+>   - 从频道URL中提取，例如 `https://www.youtube.com/channel/UCJHBJ7F-nAIlMGolm0Hu4vg`
+>   - 或从 `@用户名` 格式的URL中，先访问频道页面获取真实的频道ID
+> - **示例**: `"UCJHBJ7F-nAIlMGolm0Hu4vg"`
+>
+> #### ⚙️ 可选参数:
+> **language_code** (string, 可选)
+> - **作用**: 设置语言偏好
+> - **默认值**: `"zh-CN"`
+> - **可用值**: `"zh-CN"`, `"en-US"`, `"ja-JP"`, `"ko-KR"` 等
+>
+> **country_code** (string, 可选)
+> - **作用**: 设置地区代码
+> - **默认值**: `"US"`
+> - **可用值**: `"US"`, `"JP"`, `"GB"` 等
+>
+> **continuation_token** (string, 可选)
+> - **作用**: 分页token，用于获取下一页视频
+> - **获取方式**: 从上一次请求的响应中提取
+> - **首次请求**: 不传此参数或传 `null`
+>
+> **need_format** (boolean, 可选)
+> - **作用**: 是否返回清洗后的精简数据
+> - **默认值**: `false`
+> - **可用值**:
+>   - `false` - 返回原始完整数据
+>   - `true` - 返回清洗后的精简数据（推荐）
+>
+> ### 返回数据结构 (need_format=true):
+> ```json
+> {
+>   "videos": [
+>     {
+>       "video_id": "zd3yCa1bJCM",
+>       "title": "Minecraft: DREAM! - Asleep Custom Map",
+>       "thumbnail": "https://i.ytimg.com/vi/zd3yCa1bJCM/hqdefault.jpg",
+>       "thumbnails": [
+>         {"url": "...", "width": 168, "height": 94},
+>         {"url": "...", "width": 336, "height": 188}
+>       ],
+>       "moving_thumbnail": "https://i.ytimg.com/an_webp/zd3yCa1bJCM/mqdefault_6s.webp?...",
+>       "duration": "16:57",
+>       "duration_accessibility": "16分钟57秒钟",
+>       "view_count": "343,369次观看",
+>       "short_view_count": "34万次观看",
+>       "published_time": "18小时前",
+>       "description": "Today, we're trapped in a super weird dream...",
+>       "is_live": false,
+>       "is_verified": true,
+>       "url": "https://www.youtube.com/watch?v=zd3yCa1bJCM",
+>       "playback_url": "https://rr5---sn-ogueln67.googlevideo.com/initplayback?..."
+>     }
+>   ],
+>   "continuation_token": "下一页token"
+> }
+> ```
+>
+> ### 清洗后的字段说明:
+> - `video_id`: 视频ID
+> - `title`: 视频标题
+> - `thumbnail`: 最高清晰度缩略图URL
+> - `thumbnails`: 所有分辨率的缩略图列表
+> - `moving_thumbnail`: 动态缩略图URL（webp格式，鼠标悬停预览）
+> - `duration`: 视频时长（如"16:57"）
+> - `duration_accessibility`: 时长无障碍文本（如"16分钟57秒钟"）
+> - `view_count`: 完整观看次数（如"343,369次观看"）
+> - `short_view_count`: 简短观看次数（如"34万次观看"）
+> - `published_time`: 发布时间（如"18小时前"）
+> - `description`: 视频描述片段
+> - `is_live`: 是否为直播
+> - `is_verified`: 频道是否已认证
+> - `url`: 视频播放页URL
+> - `playback_url`: 视频播放初始化URL（googlevideo.com，可能为空）
+> - `continuation_token`: 下一页的分页token
+>
+> # [English]
+> ### Purpose:
+> - Get YouTube channel video list V3
+> - 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/UCJHBJ7F-nAIlMGolm0Hu4vg`
+>   - Or visit the channel page to get the real channel ID from `@username` format URLs
+> - **Example**: `"UCJHBJ7F-nAIlMGolm0Hu4vg"`
+>
+> #### ⚙️ 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.
+>
+> **continuation_token** (string, optional)
+> - **Purpose**: Pagination token for next page
+> - **How to get**: Extract from previous response
+> - **First request**: Omit or set to `null`
+>
+> **need_format** (boolean, optional)
+> - **Purpose**: Whether to return cleaned simplified data
+> - **Default**: `false`
+> - **Values**:
+>   - `false` - Return raw complete data
+>   - `true` - Return cleaned simplified data (recommended)
+>
+> ### Response Structure (need_format=true):
+> ```json
+> {
+>   "videos": [
+>     {
+>       "video_id": "zd3yCa1bJCM",
+>       "title": "Minecraft: DREAM! - Asleep Custom Map",
+>       "thumbnail": "https://i.ytimg.com/vi/zd3yCa1bJCM/hqdefault.jpg",
+>       "thumbnails": [
+>         {"url": "...", "width": 168, "height": 94},
+>         {"url": "...", "width": 336, "height": 188}
+>       ],
+>       "moving_thumbnail": "https://i.ytimg.com/an_webp/zd3yCa1bJCM/mqdefault_6s.webp?...",
+>       "duration": "16:57",
+>       "duration_accessibility": "16 minutes, 57 seconds",
+>       "view_count": "343,369 views",
+>       "short_view_count": "343K views",
+>       "published_time": "18 hours ago",
+>       "description": "Today, we're trapped in a super weird dream...",
+>       "is_live": false,
+>       "is_verified": true,
+>       "url": "https://www.youtube.com/watch?v=zd3yCa1bJCM",
+>       "playback_url": "https://rr5---sn-ogueln67.googlevideo.com/initplayback?..."
+>     }
+>   ],
+>   "continuation_token": "next page token"
+> }
+> ```
+>
+> ### Cleaned Data Field Descriptions:
+> - `video_id`: Video ID
+> - `title`: Video title
+> - `thumbnail`: Highest resolution thumbnail URL
+> - `thumbnails`: List of all resolution thumbnails
+> - `moving_thumbnail`: Moving thumbnail URL (webp format, hover preview)
+> - `duration`: Video duration (e.g., "16:57")
+> - `duration_accessibility`: Duration accessibility text (e.g., "16 minutes, 57 seconds")
+> - `view_count`: Full view count (e.g., "343,369 views")
+> - `short_view_count`: Short view count (e.g., "343K views")
+> - `published_time`: Published time (e.g., "18 hours ago")
+> - `description`: Video description snippet
+> - `is_live`: Whether it's a live stream
+> - `is_verified`: Whether the channel is verified
+> - `url`: Video playback page URL
+> - `playback_url`: Video playback initialization URL (googlevideo.com, may be empty)
+> - `continuation_token`: Pagination token for next page
+>
+> # [示例/Examples]
+> ## 获取频道首页视频 / Get first page of channel videos
+> GET /youtube_web/get_channel_videos_v3?channel_id=UCJHBJ7F-nAIlMGolm0Hu4vg
+>
+> ## 获取清洗后的数据（推荐）/ Get cleaned data (recommended)
+> GET /youtube_web/get_channel_videos_v3?channel_id=UCJHBJ7F-nAIlMGolm0Hu4vg&need_format=true
+>
+> ## 获取下一页 / Get next page
+> GET /youtube_web/get_channel_videos_v3?channel_id=UCJHBJ7F-nAIlMGolm0Hu4vg&continuation_token=xxxxx&need_format=true
+
+#### Parameters
+
+| Field | In | Type | Required | Description | Default | Example | Enum |
+| --- | --- | --- | --- | --- | --- | --- | --- |
+| channel_id | query | string | Yes | 频道ID/Channel ID | None | UCJHBJ7F-nAIlMGolm0Hu4vg | None |
+| language_code | query | string | No | 语言代码（如zh-CN, en-US等）/Language code | zh-CN | zh-CN | None |
+| country_code | query | string | No | 国家代码（如US, JP等）/Country code | US | US | None |
+| continuation_token | query | string | No | 分页token，用于获取下一页/Pagination token for next page | None | None | None |
+| need_format | query | boolean | No | 是否需要清洗数据，提取关键内容，移除冗余数据/Whether to clean and format the data | false | None | None |
+
+#### Request Body
+
+None
+
+#### Success Response
+
+##### `200 application/json`
+
+- Schema summary: `code`:integer, `request_id`:string, `message`:string, `message_zh`:string, `support`:string, `time`:string, `time_stamp`:integer, `time_zone`:string, ...
+
+| Field | Type | Required | Description | Default | Example | Enum |
+| --- | --- | --- | --- | --- | --- | --- |
+| code | integer | No | HTTP status code \| HTTP状态码 | 200 | None | None |
+| request_id | string | No | Unique request identifier \| 唯一请求标识符 | None | None | None |
+| message | string | No | Response message (EN-US) \| 响应消息 (English) | Request successful. This request will incur a charge. | None | None |
+| message_zh | string | No | Response message (ZH-CN) \| 响应消息 (中文) | 请求成功，本次请求将被计费。 | None | None |
+| support | string | No | Support message \| 支持消息 | Discord: https://discord.gg/aMEAS8Xsvz | None | None |
+| time | string | No | The time the response was generated \| 生成响应的时间 | None | None | None |
+| time_stamp | integer | No | The timestamp the response was generated \| 生成响应的时间戳 | None | None | None |
+| time_zone | string | No | The timezone of the response time \| 响应时间的时区 | America/Los_Angeles | None | None |
+| docs | string | No | Link to the API Swagger documentation for this endpoint \| 此端点的 API Swagger 文档链接 | None | None | None |
+| cache_message | string | No | Cache message (EN-US) \| 缓存消息 (English) | This request will be cached. You can access the cached result directly using th… | None | None |
+| cache_message_zh | string | No | Cache message (ZH-CN) \| 缓存消息 (中文) | 本次请求将被缓存，你可以使用下面的 URL 直接访问缓存结果，有效期为 24 小时，访问缓存不会产生额外费用。 | None | None |
+| cache_url | string | No | The URL to access the cached result \| 访问缓存结果的 URL | None | None | None |
+| router | string | No | The endpoint that generated this response \| 生成此响应的端点 | None | None | None |
+| params | dynamic object | No | The parameters used in the request \| 请求中使用的参数 | None | None | None |
+| data | null | No | The response data \| 响应数据 | None | None | None |
+
+<a id="get-api-u1-v1-youtube-web-get-general-search"></a>
+### `GET /api/u1/v1/youtube/web/get_general_search`
+
+- Summary: 综合搜索（支持过滤条件）/General search with filters
+- Capabilities: search
+- Auth: Header `Authorization: Bearer {token}`; docs also allow Cookie `Authorization` as fallback (`HTTPBearer`)
+- operationId: `get_general_search_api_v1_youtube_web_get_general_search_get`
+
+#### Notes
+
+> # [中文]
+> ### 用途:
+> - YouTube综合搜索，支持多种过滤条件，可以精确筛选搜索结果
+>
+> ### 参数详解:
+> - **search_query**: 搜索关键字
+> - **language_code**: 语言代码，推荐使用zh-CN（中文）或en-US（英文）
+> - **country_code**: 国家代码，影响搜索结果的地区相关性
+> - **time_zone**: 时区设置
+>
+> ### 过滤条件 (选择一个值即可):
+> #### 上传时间 (upload_time):
+> - `hour`: 过去1小时内上传
+> - `today`: 今天上传
+> - `week`: 本周上传
+> - `month`: 本月上传
+> - `year`: 今年上传
+>
+> #### 视频时长 (duration):
+> - `short`: 短视频（少于4分钟）
+> - `medium`: 中等时长（4-20分钟）
+> - `long`: 长视频（超过20分钟）
+>
+> #### 内容类型 (content_type):
+> - `video`: 视频
+> - `channel`: 频道
+> - `playlist`: 播放列表
+> - `movie`: 电影
+>
+> #### 特征 (feature):
+> - `hd`: 高清视频
+> - `4k`: 4K视频
+> - `subtitles`: 包含字幕
+> - `live`: 直播
+> - `creative_commons`: 知识共享许可
+> - `360`: 360度视频
+> - `vr180`: VR180视频
+> - `3d`: 3D视频
+> - `hdr`: HDR视频
+> - `location`: 包含位置信息
+> - `purchased`: 已购买内容
+>
+> #### 排序方式 (sort_by):
+> - `relevance`: 相关性（默认）
+> - `upload_date`: 上传日期
+> - `view_count`: 观看次数
+> - `rating`: 评分
+>
+> ### 返回:
+> - 包含过滤条件的搜索结果
+>
+> # [English]
+> ### Purpose:
+> - YouTube comprehensive search with multiple filter options for precise result filtering
+>
+> ### Parameters:
+> - **search_query**: Search keyword
+> - **language_code**: Language code (zh-CN for Chinese, en-US for English)
+> - **country_code**: Country code affecting regional relevance
+> - **time_zone**: Time zone setting
+>
+> ### Filter Options (select one value for each):
+> #### Upload Time (upload_time):
+> - `hour`: Uploaded in the past hour
+> - `today`: Uploaded today
+> - `week`: Uploaded this week
+> - `month`: Uploaded this month
+> - `year`: Uploaded this year
+>
+> #### Duration (duration):
+> - `short`: Short videos (under 4 minutes)
+> - `medium`: Medium length (4-20 minutes)
+> - `long`: Long videos (over 20 minutes)
+>
+> #### Content Type (content_type):
+> - `video`: Videos
+> - `channel`: Channels
+> - `playlist`: Playlists
+> - `movie`: Movies
+>
+> #### Features (feature):
+> - `hd`: High definition
+> - `4k`: 4K videos
+> - `subtitles`: With subtitles
+> - `live`: Live streams
+> - `creative_commons`: Creative Commons licensed
+> - `360`: 360-degree videos
+> - `vr180`: VR180 videos
+> - `3d`: 3D videos
+> - `hdr`: HDR videos
+> - `location`: With location info
+> - `purchased`: Purchased content
+>
+> #### Sort By (sort_by):
+> - `relevance`: Relevance (default)
+> - `upload_date`: Upload date
+> - `view_count`: View count
+> - `rating`: Rating
+>
+> ### Returns:
+> - Filtered search results
+>
+> # [示例/Examples]
+> ## 基础搜索
+> GET /youtube_web/get_general_search?search_query=Python编程
+>
+> ## 搜索本周上传的Python编程短视频
+> GET /youtube_web/get_general_search?search_query=Python编程&upload_time=week&duration=short
+>
+> ## 搜索高清的Python教程视频，按观看次数排序
+> GET /youtube_web/get_general_search?search_query=Python tutorial&feature=hd&sort_by=view_count
+>
+> ## 搜索今天上传的4K编程直播
+> GET /youtube_web/get_general_search?search_query=programming&upload_time=today&feature=4k&content_type=video
+
+#### Parameters
+
+| Field | In | Type | Required | Description | Default | Example | Enum |
+| --- | --- | --- | --- | --- | --- | --- | --- |
+| search_query | query | string | Yes | 搜索关键字/Search keyword | None | Python编程 | None |
+| language_code | query | string | No | 语言代码（如zh-CN, en-US等）/Language code | zh-CN | None | None |
+| country_code | query | string | No | 国家代码（如US, CN等）/Country code | US | None | None |
+| time_zone | query | string | No | 时区（如America/Los_Angeles, Asia/Shanghai等）/Time zone | America/Los_Angeles | None | None |
+| upload_time | query | string enum[hour, today, week, month, year] | No | 上传时间过滤 \| Upload time filter | None | None | None |
+| duration | query | string enum[short, medium, long] | No | 视频时长过滤 \| Duration filter | None | None | None |
+| content_type | query | string enum[video, channel, playlist, movie] | No | 内容类型过滤 \| Content type filter | None | None | None |
+| feature | query | string enum[live, 4k, hd, subtitles, creative_commons, 360, ...] | No | 特征过滤 \| Feature filter | None | None | None |
+| sort_by | query | string enum[relevance, upload_date, view_count, rating] | No | 排序方式 \| Sort by | None | None | None |
+| continuation_token | query | string | No | 翻页令牌/Pagination token | None | None | None |
+
+#### Request Body
+
+None
+
+#### Success Response
+
+##### `200 application/json`
+
+- Schema summary: `code`:integer, `request_id`:string, `message`:string, `message_zh`:string, `support`:string, `time`:string, `time_stamp`:integer, `time_zone`:string, ...
+
+| Field | Type | Required | Description | Default | Example | Enum |
+| --- | --- | --- | --- | --- | --- | --- |
+| code | integer | No | HTTP status code \| HTTP状态码 | 200 | None | None |
+| request_id | string | No | Unique request identifier \| 唯一请求标识符 | None | None | None |
+| message | string | No | Response message (EN-US) \| 响应消息 (English) | Request successful. This request will incur a charge. | None | None |
+| message_zh | string | No | Response message (ZH-CN) \| 响应消息 (中文) | 请求成功，本次请求将被计费。 | None | None |
+| support | string | No | Support message \| 支持消息 | Discord: https://discord.gg/aMEAS8Xsvz | None | None |
+| time | string | No | The time the response was generated \| 生成响应的时间 | None | None | None |
+| time_stamp | integer | No | The timestamp the response was generated \| 生成响应的时间戳 | None | None | None |
+| time_zone | string | No | The timezone of the response time \| 响应时间的时区 | America/Los_Angeles | None | None |
+| docs | string | No | Link to the API Swagger documentation for this endpoint \| 此端点的 API Swagger 文档链接 | None | None | None |
+| cache_message | string | No | Cache message (EN-US) \| 缓存消息 (English) | This request will be cached. You can access the cached result directly using th… | None | None |
+| cache_message_zh | string | No | Cache message (ZH-CN) \| 缓存消息 (中文) | 本次请求将被缓存，你可以使用下面的 URL 直接访问缓存结果，有效期为 24 小时，访问缓存不会产生额外费用。 | None | None |
+| cache_url | string | No | The URL to access the cached result \| 访问缓存结果的 URL | None | None | None |
+| router | string | No | The endpoint that generated this response \| 生成此响应的端点 | None | None | None |
+| params | dynamic object | No | The parameters used in the request \| 请求中使用的参数 | None | None | None |
+| data | null | No | The response data \| 响应数据 | None | None | None |
+
+<a id="get-api-u1-v1-youtube-web-get-relate-video"></a>
+### `GET /api/u1/v1/youtube/web/get_relate_video`
+
+- Summary: 获取推荐视频/Get related videos
+- Capabilities: content details
+- Auth: Header `Authorization: Bearer {token}`; docs also allow Cookie `Authorization` as fallback (`HTTPBearer`)
+- operationId: `get_relate_video_api_v1_youtube_web_get_relate_video_get`
+
+#### Notes
+
+> # [中文]
+> ### 用途:
+> - 根据视频ID获取推荐视频数据。
+> ### 参数:
+> - video_id: 视频ID，从URL中获取，例如：https://www.youtube.com/watch?v=LuIL5JATZsc，这里的video_id就是LuIL5JATZsc。
+> - continuation_token: 用于继续获取推荐视频的令牌。默认为None。
+> ### 返回:
+> - 推荐视频数据。
+>
+> # [English]
+> ### Purpose:
+> - Get related videos by video ID.
+> ### Parameters:
+> - video_id: Video ID, get it from the URL, for example: https://www.youtube.com/watch?v=LuIL5JATZsc, the id is LuIL5JATZsc.
+> - continuation_token: Token to continue fetching related videos. Default is None.
+> ### Returns:
+> - Related videos.
+>
+> # [示例/Example]
+> video_id = "LuIL5JATZsc"
+
+#### Parameters
+
+| Field | In | Type | Required | Description | Default | Example | Enum |
+| --- | --- | --- | --- | --- | --- | --- | --- |
+| video_id | query | string | Yes | 视频ID/Video ID | None | LuIL5JATZsc | None |
+| continuation_token | query | string | No | 翻页令牌/Pagination token | None | None | None |
+
+#### Request Body
+
+None
+
+#### Success Response
+
+##### `200 application/json`
+
+- Schema summary: `code`:integer, `request_id`:string, `message`:string, `message_zh`:string, `support`:string, `time`:string, `time_stamp`:integer, `time_zone`:string, ...
+
+| Field | Type | Required | Description | Default | Example | Enum |
+| --- | --- | --- | --- | --- | --- | --- |
+| code | integer | No | HTTP status code \| HTTP状态码 | 200 | None | None |
+| request_id | string | No | Unique request identifier \| 唯一请求标识符 | None | None | None |
+| message | string | No | Response message (EN-US) \| 响应消息 (English) | Request successful. This request will incur a charge. | None | None |
+| message_zh | string | No | Response message (ZH-CN) \| 响应消息 (中文) | 请求成功，本次请求将被计费。 | None | None |
+| support | string | No | Support message \| 支持消息 | Discord: https://discord.gg/aMEAS8Xsvz | None | None |
+| time | string | No | The time the response was generated \| 生成响应的时间 | None | None | None |
+| time_stamp | integer | No | The timestamp the response was generated \| 生成响应的时间戳 | None | None | None |
+| time_zone | string | No | The timezone of the response time \| 响应时间的时区 | America/Los_Angeles | None | None |
+| docs | string | No | Link to the API Swagger documentation for this endpoint \| 此端点的 API Swagger 文档链接 | None | None | None |
+| cache_message | string | No | Cache message (EN-US) \| 缓存消息 (English) | This request will be cached. You can access the cached result directly using th… | None | None |
+| cache_message_zh | string | No | Cache message (ZH-CN) \| 缓存消息 (中文) | 本次请求将被缓存，你可以使用下面的 URL 直接访问缓存结果，有效期为 24 小时，访问缓存不会产生额外费用。 | None | None |
+| cache_url | string | No | The URL to access the cached result \| 访问缓存结果的 URL | None | None | None |
+| router | string | No | The endpoint that generated this response \| 生成此响应的端点 | None | None | None |
+| params | dynamic object | No | The parameters used in the request \| 请求中使用的参数 | None | None | None |
+| data | null | No | The response data \| 响应数据 | None | None | None |
+
+<a id="get-api-u1-v1-youtube-web-get-shorts-search"></a>
+### `GET /api/u1/v1/youtube/web/get_shorts_search`
+
+- Summary: YouTube Shorts短视频搜索/YouTube Shorts search
+- Capabilities: search
+- Auth: Header `Authorization: Bearer {token}`; docs also allow Cookie `Authorization` as fallback (`HTTPBearer`)
+- operationId: `get_shorts_search_api_v1_youtube_web_get_shorts_search_get`
+
+#### Notes
+
+> # [中文]
+> ### 用途:
+> - YouTube Shorts短视频专门搜索，使用原生YouTube API接口
+>
+> ### 特点:
+> - 🎬 专门搜索YouTube Shorts短视频（<60秒）
+> - 🔍 支持多种过滤条件和排序方式
+> - 📱 优化的移动端短视频内容
+> - ⚡ 智能过滤：首次请求可能返回混合内容（长视频+短视频），默认自动过滤长视频
+>
+> ### 重要说明 - YouTube Shorts搜索机制:
+> 根据YouTube的搜索逻辑，Shorts搜索有以下特性：
+> 1. **首次请求**（无continuation_token）：可能返回混合内容（部分长视频 + 部分短视频）
+> 2. **后续请求**（有continuation_token）：仅返回纯短视频内容
+> 3. **解决方案**：
+>    - 方案A：使用 `filter_mixed_content=true`（默认），自动过滤掉长视频
+>    - 方案B：使用第一次返回的 continuation_token 进行第二次请求，获取纯Shorts内容
+>    - 方案C：设置 `filter_mixed_content=false`，获取原始混合内容
+>
+> ### 参数详解:
+>
+> #### 📌 必选参数 (Required Parameters):
+>
+> **search_query** (string)
+> - **作用**: 搜索关键字，用于匹配Shorts视频的标题、描述等内容
+> - **格式**: 任意字符串
+> - **示例**: `"Python编程"`, `"gaming"`, `"cooking tutorial"`
+> - **注意**: 支持中英文及其他语言，空格会被自动处理
+>
+> #### ⚙️ 可选参数 - 基础设置 (Optional Parameters - Basic Settings):
+>
+> **language_code** (string, 可选)
+> - **作用**: 设置搜索结果的显示语言，影响返回内容的语言偏好
+> - **默认值**: `"en-US"`
+> - **可用值**:
+>   - `"zh-CN"` - 简体中文
+>   - `"zh-TW"` - 繁体中文
+>   - `"en-US"` - 英语（美国）
+>   - `"en-GB"` - 英语（英国）
+>   - `"ja-JP"` - 日语
+>   - `"ko-KR"` - 韩语
+>   - `"es-ES"` - 西班牙语
+>   - `"fr-FR"` - 法语
+>   - `"de-DE"` - 德语
+>   - 其他符合IETF BCP 47标准的语言代码
+> - **示例**: `language_code=zh-CN`
+> - **影响**: 会影响搜索算法的语言匹配和结果排序
+>
+> **country_code** (string, 可选)
+> - **作用**: 设置地区/国家代码，影响搜索结果的地域相关性和内容可用性
+> - **默认值**: `"US"`
+> - **可用值**:
+>   - `"US"` - 美国
+>   - `"CN"` - 中国
+>   - `"JP"` - 日本
+>   - `"KR"` - 韩国
+>   - `"GB"` - 英国
+>   - `"DE"` - 德国
+>   - `"FR"` - 法国
+>   - `"CA"` - 加拿大
+>   - 其他符合ISO 3166-1 alpha-2标准的国家代码
+> - **示例**: `country_code=JP`
+> - **影响**: 某些Shorts可能因地区限制而不可见
+>
+> **time_zone** (string, 可选)
+> - **作用**: 设置时区，影响时间相关过滤器（如"今天"、"本周"）的计算
+> - **默认值**: `"America/Los_Angeles"`
+> - **可用值**: 符合IANA时区数据库的时区标识符
+>   - `"America/Los_Angeles"` - 美国太平洋时区
+>   - `"America/New_York"` - 美国东部时区
+>   - `"Asia/Shanghai"` - 中国时区
+>   - `"Asia/Tokyo"` - 日本时区
+>   - `"Europe/London"` - 英国时区
+>   - `"Europe/Paris"` - 法国时区
+> - **示例**: `time_zone=Asia/Shanghai`
+> - **影响**: 结合upload_time参数使用时，决定"今天"等时间段的具体范围
+>
+> **filter_mixed_content** (boolean, 可选)
+> - **作用**: 控制是否自动过滤掉响应中的长视频（非Shorts内容）
+> - **默认值**: `true`
+> - **可用值**:
+>   - `true` - 自动过滤长视频，只返回Shorts（推荐）
+>   - `false` - 返回原始内容，可能包含长视频
+> - **示例**: `filter_mixed_content=true`
+> - **使用场景**:
+>   - `true`: 当你只需要纯Shorts内容时使用（推荐首次请求使用）
+>   - `false`: 当你需要分析YouTube原始返回的混合内容时使用（调试用）
+> - **注意**: 只影响首次请求，使用continuation_token的请求本身就只返回Shorts
+>
+> #### 🎯 可选参数 - Shorts过滤条件 (Optional Parameters - Shorts Filters):
+>
+> **upload_time** (string, 可选)
+> - **作用**: 按上传时间过滤Shorts，只返回指定时间段内上传的视频
+> - **默认值**: `null` (不过滤)
+> - **可用值**:
+>   - `"hour"` - 过去1小时内上传
+>   - `"today"` - 今天上传（基于time_zone参数）
+>   - `"week"` - 本周上传（最近7天）
+>   - `"month"` - 本月上传（最近30天）
+>   - `"year"` - 今年上传（最近365天）
+> - **示例**: `upload_time=week`
+> - **使用场景**: 寻找最新、热门的Shorts内容
+> - **注意**: 与time_zone参数配合使用，时间计算基于设定的时区
+>
+> **sort_by** (string, 可选)
+> - **作用**: 设置搜索结果的排序方式
+> - **默认值**: `null` (YouTube默认相关性排序)
+> - **可用值**:
+>   - `"relevance"` - 按相关性排序（YouTube默认算法）
+>   - `"upload_date"` - 按上传日期排序（最新优先）
+>   - `"view_count"` - 按观看次数排序（最多观看优先）
+>   - `"rating"` - 按评分排序（最高评分优先）
+> - **示例**: `sort_by=view_count`
+> - **使用场景**:
+>   - `relevance`: 寻找最相关的内容
+>   - `upload_date`: 寻找最新发布的Shorts
+>   - `view_count`: 寻找最受欢迎的Shorts
+>   - `rating`: 寻找质量最高的Shorts
+> - **优先级**: sort_by的优先级高于upload_time，两者同时使用时以sort_by为准
+>
+> #### 📄 可选参数 - 翻页控制 (Optional Parameters - Pagination):
+>
+> **continuation_token** (string, 可选)
+> - **作用**: 用于获取下一页搜索结果的翻页令牌
+> - **默认值**: `null` (获取第一页)
+> - **格式**: YouTube返回的加密字符串
+> - **示例**: `continuation_token=EqcBEgPkuKzor4YybhmgGk...`
+> - **获取方式**: 从上一次请求的响应中提取（见"翻页机制详解"部分）
+> - **使用场景**:
+>   - 首次搜索：不传此参数，获取第一页结果
+>   - 后续翻页：传入上次返回的token，获取下一页结果
+> - **注意**:
+>   - Token有时效性，通常在数小时内有效
+>   - 使用continuation_token时，必须保持search_query等其他参数一致
+>   - 使用token的请求会自动返回纯Shorts内容（无需过滤）
+>
+> ### 翻页机制详解:
+> #### 如何获取 continuation_token：
+> 从响应JSON中提取，路径通常为以下之一：
+> ```python
+> # 路径1：在 onResponseReceivedCommands 中
+> response["data"]["onResponseReceivedCommands"][0]["appendContinuationItemsAction"]["continuationItems"][-1]["continuationItemRenderer"]["continuationEndpoint"]["continuationCommand"]["token"]
+>
+> # 路径2：在 contents 中
+> response["data"]["contents"]["twoColumnSearchResultsRenderer"]["primaryContents"]["sectionListRenderer"]["contents"][-1]["continuationItemRenderer"]["continuationEndpoint"]["continuationCommand"]["token"]
+> ```
+>
+> #### 使用流程：
+> 1. **首次请求**: 不传 continuation_token
+>    ```
+>    GET /api/v1/youtube_web/get_shorts_search?search_query=python
+>    ```
+> 2. **提取token**: 从响应中找到 continuation_token
+> 3. **后续请求**: 传入 continuation_token 获取下一页
+>    ```
+>    GET /api/v1/youtube_web/get_shorts_search?search_query=python&continuation_token=xxx
+>    ```
+>
+> ### 响应数据结构:
+> ```json
+> {
+>   "code": 200,
+>   "data": {
+>     "contents": {
+>       "twoColumnSearchResultsRenderer": {
+>         "primaryContents": {
+>           "sectionListRenderer": {
+>             "contents": [
+>               {
+>                 "itemSectionRenderer": {
+>                   "contents": [
+>                     {
+>                       "gridShelfViewModel": {
+>                         // Shorts视频列表
+>                         "items": [...]
+>                       }
+>                     }
+>                   ]
+>                 }
+>               },
+>               {
+>                 "continuationItemRenderer": {
+>                   "continuationEndpoint": {
+>                     "continuationCommand": {
+>                       "token": "xxx"  // 下一页的token
+>                     }
+>                   }
+>                 }
+>               }
+>             ]
+>           }
+>         }
+>       }
+>     }
+>   }
+> }
+> ```
+>
+> ### 返回:
+> - 专门针对Shorts的搜索结果，包含视频列表和翻页token
+>
+> # [English]
+> ### Purpose:
+> - YouTube Shorts specialized search using native YouTube API
+>
+> ### Features:
+> - 🎬 Specialized search for YouTube Shorts (<60 seconds)
+> - 🔍 Support for multiple filter conditions and sorting options
+> - 📱 Optimized for mobile short-form content
+> - ⚡ Smart filtering: First request may return mixed content (long+short videos), automatically filters long videos by default
+>
+> ### Important - YouTube Shorts Search Mechanism:
+> According to YouTube's search logic, Shorts search has these characteristics:
+> 1. **First request** (no continuation_token): May return mixed content (some long videos + some short videos)
+> 2. **Subsequent requests** (with continuation_token): Returns only pure Shorts content
+> 3. **Solutions**:
+>    - Solution A: Use `filter_mixed_content=true` (default) to automatically filter long videos
+>    - Solution B: Use continuation_token from first response for second request to get pure Shorts
+>    - Solution C: Set `filter_mixed_content=false` to get original mixed content
+>
+> ### Parameters:
+> - **search_query**: Search keyword
+> - **language_code**: Language code (zh-CN for Chinese, en-US for English)
+> - **country_code**: Country code affecting regional relevance
+> - **time_zone**: Time zone (e.g., America/Los_Angeles, Asia/Shanghai)
+> - **filter_mixed_content**: Whether to filter long videos from mixed content (default true)
+>
+> ### Shorts-specific Filters:
+> #### Upload Time (upload_time):
+> - `hour`: Shorts uploaded in the past hour
+> - `today`: Shorts uploaded today
+> - `week`: Shorts uploaded this week
+> - `month`: Shorts uploaded this month
+> - `year`: Shorts uploaded this year
+>
+> #### Sort By (sort_by):
+> - `relevance`: Relevance (default)
+> - `upload_date`: Upload date
+> - `view_count`: View count
+> - `rating`: Rating
+>
+> ### Pagination Mechanism Explained:
+> #### How to get continuation_token:
+> Extract from response JSON, typically at one of these paths:
+> ```python
+> # Path 1: In onResponseReceivedCommands
+> response["onResponseReceivedCommands"][0]["appendContinuationItemsAction"]["continuationItems"][-1]["continuationItemRenderer"]["continuationEndpoint"]["continuationCommand"]["token"]
+>
+> # Path 2: In contents
+> response["contents"]["twoColumnSearchResultsRenderer"]["primaryContents"]["sectionListRenderer"]["contents"][-1]["continuationItemRenderer"]["continuationEndpoint"]["continuationCommand"]["token"]
+> ```
+>
+> #### Usage Flow:
+> 1. **First request**: Don't pass continuation_token
+>    ```
+>    GET /api/v1/youtube_web/get_shorts_search?search_query=python
+>    ```
+> 2. **Extract token**: Find continuation_token in response
+> 3. **Next requests**: Pass continuation_token to get next page
+>    ```
+>    GET /api/v1/youtube_web/get_shorts_search?search_query=python&continuation_token=xxx
+>    ```
+>
+> ### Response Data Structure:
+> ```json
+> {
+>   "code": 200,
+>   "data": {
+>     "contents": {
+>       "twoColumnSearchResultsRenderer": {
+>         "primaryContents": {
+>           "sectionListRenderer": {
+>             "contents": [
+>               {
+>                 "itemSectionRenderer": {
+>                   "contents": [
+>                     {
+>                       "gridShelfViewModel": {
+>                         // Shorts video list
+>                         "items": [...]
+>                       }
+>                     }
+>                   ]
+>                 }
+>               },
+>               {
+>                 "continuationItemRenderer": {
+>                   "continuationEndpoint": {
+>                     "continuationCommand": {
+>                       "token": "xxx"  // Token for next page
+>                     }
+>                   }
+>                 }
+>               }
+>             ]
+>           }
+>         }
+>       }
+>     }
+>   }
+> }
+> ```
+>
+> ### Returns:
+> - Shorts-specific search results with video list and pagination token
+>
+> # [示例/Examples]
+> ## 基础Shorts搜索（自动过滤长视频）
+> GET /youtube_web/get_shorts_search?search_query=Python编程
+>
+> ## 获取原始混合内容（包含长视频）
+> GET /youtube_web/get_shorts_search?search_query=Python编程&filter_mixed_content=false
+>
+> ## 搜索本周上传的Python相关Shorts
+> GET /youtube_web/get_shorts_search?search_query=python&upload_time=week
+>
+> ## 搜索观看次数最多的技术Shorts
+> GET /youtube_web/get_shorts_search?search_query=技术&sort_by=view_count
+>
+> ## 翻页获取更多Shorts
+> GET /youtube_web/get_shorts_search?search_query=编程&continuation_token=EqcBEgPkuKzor4YybhmgGk...
+
+#### Parameters
+
+| Field | In | Type | Required | Description | Default | Example | Enum |
+| --- | --- | --- | --- | --- | --- | --- | --- |
+| search_query | query | string | Yes | 搜索关键字/Search keyword | None | Python编程 | None |
+| language_code | query | string | No | 语言代码（如zh-CN, en-US等）/Language code | en-US | en-US | None |
+| country_code | query | string | No | 国家代码（如US, CN等）/Country code | US | US | None |
+| time_zone | query | string | No | 时区（如America/Los_Angeles, Asia/Shanghai等）/Time zone | America/Los_Angeles | America/Los_Angeles | None |
+| upload_time | query | string enum[hour, today, week, month, year] | No | 上传时间过滤 \| Upload time filter for Shorts | None | None | None |
+| sort_by | query | string enum[relevance, upload_date, view_count, rating] | No | 排序方式 \| Sort by for Shorts | None | None | None |
+| continuation_token | query | string | No | 翻页令牌/Pagination token | None | None | None |
+| filter_mixed_content | query | boolean | No | 是否过滤混合内容（长视频），默认True / Filter mixed content (long videos), default True | true | true | None |
+
+#### Request Body
+
+None
+
+#### Success Response
+
+##### `200 application/json`
+
+- Schema summary: `code`:integer, `request_id`:string, `message`:string, `message_zh`:string, `support`:string, `time`:string, `time_stamp`:integer, `time_zone`:string, ...
+
+| Field | Type | Required | Description | Default | Example | Enum |
+| --- | --- | --- | --- | --- | --- | --- |
+| code | integer | No | HTTP status code \| HTTP状态码 | 200 | None | None |
+| request_id | string | No | Unique request identifier \| 唯一请求标识符 | None | None | None |
+| message | string | No | Response message (EN-US) \| 响应消息 (English) | Request successful. This request will incur a charge. | None | None |
+| message_zh | string | No | Response message (ZH-CN) \| 响应消息 (中文) | 请求成功，本次请求将被计费。 | None | None |
+| support | string | No | Support message \| 支持消息 | Discord: https://discord.gg/aMEAS8Xsvz | None | None |
+| time | string | No | The time the response was generated \| 生成响应的时间 | None | None | None |
+| time_stamp | integer | No | The timestamp the response was generated \| 生成响应的时间戳 | None | None | None |
+| time_zone | string | No | The timezone of the response time \| 响应时间的时区 | America/Los_Angeles | None | None |
+| docs | string | No | Link to the API Swagger documentation for this endpoint \| 此端点的 API Swagger 文档链接 | None | None | None |
+| cache_message | string | No | Cache message (EN-US) \| 缓存消息 (English) | This request will be cached. You can access the cached result directly using th… | None | None |
+| cache_message_zh | string | No | Cache message (ZH-CN) \| 缓存消息 (中文) | 本次请求将被缓存，你可以使用下面的 URL 直接访问缓存结果，有效期为 24 小时，访问缓存不会产生额外费用。 | None | None |
+| cache_url | string | No | The URL to access the cached result \| 访问缓存结果的 URL | None | None | None |
+| router | string | No | The endpoint that generated this response \| 生成此响应的端点 | None | None | None |
+| params | dynamic object | No | The parameters used in the request \| 请求中使用的参数 | None | None | None |
+| data | null | No | The response data \| 响应数据 | None | None | None |
+
+<a id="get-api-u1-v1-youtube-web-get-trending-videos"></a>
+### `GET /api/u1/v1/youtube/web/get_trending_videos`
+
+- Summary: 获取趋势视频/Get trending videos
+- Capabilities: trends / rankings / content details
+- Auth: Header `Authorization: Bearer {token}`; docs also allow Cookie `Authorization` as fallback (`HTTPBearer`)
+- operationId: `get_trending_videos_api_v1_youtube_web_get_trending_videos_get`
+
+#### Notes
+
+> # [中文]
+> ### 用途:
+> - 获取趋势视频。
+> ### 参数:
+> - language_code: 语言代码，默认为en。
+> - country_code: 国家代码，默认为us。
+> - section: 类型，默认为Now，可选值为Music, Gaming, Movies。
+> ### 返回:
+> - 趋势视频。
+>
+> # [English]
+> ### Purpose:
+> - Get trending videos.
+> ### Parameters:
+> - language_code: Language code, default is en.
+> - country_code: Country code, default is us.
+> - section: Section, default is Now, optional values are Music, Gaming, Movies.
+> ### Returns:
+> - Trending videos.
+>
+> # [示例/Example]
+
+#### Parameters
+
+| Field | In | Type | Required | Description | Default | Example | Enum |
+| --- | --- | --- | --- | --- | --- | --- | --- |
+| language_code | query | string | No | 语言代码/Language code | en | None | None |
+| country_code | query | string | No | 国家代码/Country code | us | None | None |
+| section | query | string | No | 类型/Section | Now | None | None |
+
+#### Request Body
+
+None
+
+#### Success Response
+
+##### `200 application/json`
+
+- Schema summary: `code`:integer, `request_id`:string, `message`:string, `message_zh`:string, `support`:string, `time`:string, `time_stamp`:integer, `time_zone`:string, ...
+
+| Field | Type | Required | Description | Default | Example | Enum |
+| --- | --- | --- | --- | --- | --- | --- |
+| code | integer | No | HTTP status code \| HTTP状态码 | 200 | None | None |
+| request_id | string | No | Unique request identifier \| 唯一请求标识符 | None | None | None |
+| message | string | No | Response message (EN-US) \| 响应消息 (English) | Request successful. This request will incur a charge. | None | None |
+| message_zh | string | No | Response message (ZH-CN) \| 响应消息 (中文) | 请求成功，本次请求将被计费。 | None | None |
+| support | string | No | Support message \| 支持消息 | Discord: https://discord.gg/aMEAS8Xsvz | None | None |
+| time | string | No | The time the response was generated \| 生成响应的时间 | None | None | None |
+| time_stamp | integer | No | The timestamp the response was generated \| 生成响应的时间戳 | None | None | None |
+| time_zone | string | No | The timezone of the response time \| 响应时间的时区 | America/Los_Angeles | None | None |
+| docs | string | No | Link to the API Swagger documentation for this endpoint \| 此端点的 API Swagger 文档链接 | None | None | None |
+| cache_message | string | No | Cache message (EN-US) \| 缓存消息 (English) | This request will be cached. You can access the cached result directly using th… | None | None |
+| cache_message_zh | string | No | Cache message (ZH-CN) \| 缓存消息 (中文) | 本次请求将被缓存，你可以使用下面的 URL 直接访问缓存结果，有效期为 24 小时，访问缓存不会产生额外费用。 | None | None |
+| cache_url | string | No | The URL to access the cached result \| 访问缓存结果的 URL | None | None | None |
+| router | string | No | The endpoint that generated this response \| 生成此响应的端点 | None | None | None |
+| params | dynamic object | No | The parameters used in the request \| 请求中使用的参数 | None | None | None |
+| data | null | No | The response data \| 响应数据 | None | None | None |
+
+<a id="get-api-u1-v1-youtube-web-get-video-comment-replies"></a>
+### `GET /api/u1/v1/youtube/web/get_video_comment_replies`
+
+- Summary: 获取视频二级评论/Get video sub comments
+- Capabilities: comments / content details
+- Auth: Header `Authorization: Bearer {token}`; docs also allow Cookie `Authorization` as fallback (`HTTPBearer`)
+- operationId: `get_video_comment_replies_api_v1_youtube_web_get_video_comment_replies_get`
+
+#### Notes
+
+> # [中文]
+> ### 用途:
+> - 获取视频二级评论
+>
+> ### 参数详解:
+>
+> #### 📌 必选参数:
+> **continuation_token** (string)
+> - **作用**: 回复的continuation token
+> - **获取方式**: 从一级评论的响应数据中获取 `reply_continuation_token` 字段
+> - **示例**: `"Eg0SC29hU05CejRxTVFZGAYygwEaUBIaVWd3WmhjUXVGUmJZTlhkUV85VjRBYUFCQWciAggAKhhVQ0pIQko3Ri1uQUlsTUdvbG0wSHU0dmcyC29hU05CejRxTVFZQAFICoIBAggBQi9jb21tZW50LXJlcGxpZXMtaXRlbS1VZ3daaGNRdUZSYllOWGRRXzlWNEFhQUJBZw%3D%3D"`
+>
+> #### ⚙️ 可选参数:
+> **language_code** (string, 可选)
+> - **作用**: 设置回复显示的语言偏好
+> - **默认值**: `"zh-CN"`
+> - **可用值**: `"zh-CN"`, `"en-US"`, `"ja-JP"`, `"ko-KR"` 等
+>
+> **country_code** (string, 可选)
+> - **作用**: 设置地区代码
+> - **默认值**: `"US"`
+> - **可用值**: `"US"`, `"JP"`, `"GB"` 等
+>
+> **need_format** (boolean, 可选)
+> - **作用**: 是否返回清洗后的精简数据
+> - **默认值**: `false`
+> - **可用值**:
+>   - `false` - 返回原始完整数据
+>   - `true` - 返回清洗后的精简数据（推荐）
+>
+> ### 使用流程:
+> 1. 先调用 `/get_video_comments` 接口获取一级评论
+> 2. 从一级评论的响应中找到 `reply_continuation_token` 字段
+> 3. 使用该 token 调用本接口获取该评论的所有回复
+>
+> ### 返回数据结构 (need_format=true):
+> ```json
+> {
+>   "comments": [
+>     {
+>       "comment_id": "UgwZhcQuFRbYNXdQ_9V4AaABAg.A2B3C4D5E6F7G8H9I0J1",
+>       "content": "回复内容文本",
+>       "published_time": "2天前",
+>       "reply_level": 1,
+>       "like_count": "5",
+>       "like_count_a11y": "5 次赞",
+>       "reply_count": "0",
+>       "author": {
+>         "channel_id": "UCxxxxxx",
+>         "display_name": "@username",
+>         "channel_url": "https://www.youtube.com/@username",
+>         "avatar_url": "https://yt3.ggpht.com/...",
+>         "is_verified": false,
+>         "is_creator": true,
+>         "is_artist": false
+>       }
+>     }
+>   ],
+>   "continuation_token": "下一页token（如果有更多回复）"
+> }
+> ```
+>
+> ### 字段说明:
+> - `reply_level`: 回复层级（1表示二级评论/回复）
+> - `is_creator`: 是否为视频创作者（如果是创作者回复会标记为true）
+> - 其他字段与一级评论相同
+>
+> # [English]
+> ### Purpose:
+> - Get video second-level comments
+>
+> ### Parameters:
+> - id: Video ID, get it from the URL, for example: https://www.youtube.com/watch?v=LuIL5JATZsc, the id is LuIL5JATZsc.
+> - continuation_token: Token to continue fetching comments. Default is None.
+> ### Returns:
+> - Video comments.
+>
+> # [示例/Example]
+> id = "LuIL5JATZsc"
+
+#### Parameters
+
+| Field | In | Type | Required | Description | Default | Example | Enum |
+| --- | --- | --- | --- | --- | --- | --- | --- |
+| continuation_token | query | string | Yes | 回复的continuation token（从一级评论的reply_continuation_token字段获取）/Reply continuation token from first-level comment | None | None | None |
+| language_code | query | string | No | 语言代码（如zh-CN, en-US等）/Language code | zh-CN | zh-CN | None |
+| country_code | query | string | No | 国家代码（如US, JP等）/Country code | US | US | None |
+| need_format | query | boolean | No | 是否需要清洗数据，提取关键内容，移除冗余数据/Whether to clean and format the data | false | None | None |
+
+#### Request Body
+
+None
+
+#### Success Response
+
+##### `200 application/json`
+
+- Schema summary: `code`:integer, `request_id`:string, `message`:string, `message_zh`:string, `support`:string, `time`:string, `time_stamp`:integer, `time_zone`:string, ...
+
+| Field | Type | Required | Description | Default | Example | Enum |
+| --- | --- | --- | --- | --- | --- | --- |
+| code | integer | No | HTTP status code \| HTTP状态码 | 200 | None | None |
+| request_id | string | No | Unique request identifier \| 唯一请求标识符 | None | None | None |
+| message | string | No | Response message (EN-US) \| 响应消息 (English) | Request successful. This request will incur a charge. | None | None |
+| message_zh | string | No | Response message (ZH-CN) \| 响应消息 (中文) | 请求成功，本次请求将被计费。 | None | None |
+| support | string | No | Support message \| 支持消息 | Discord: https://discord.gg/aMEAS8Xsvz | None | None |
+| time | string | No | The time the response was generated \| 生成响应的时间 | None | None | None |
+| time_stamp | integer | No | The timestamp the response was generated \| 生成响应的时间戳 | None | None | None |
+| time_zone | string | No | The timezone of the response time \| 响应时间的时区 | America/Los_Angeles | None | None |
+| docs | string | No | Link to the API Swagger documentation for this endpoint \| 此端点的 API Swagger 文档链接 | None | None | None |
+| cache_message | string | No | Cache message (EN-US) \| 缓存消息 (English) | This request will be cached. You can access the cached result directly using th… | None | None |
+| cache_message_zh | string | No | Cache message (ZH-CN) \| 缓存消息 (中文) | 本次请求将被缓存，你可以使用下面的 URL 直接访问缓存结果，有效期为 24 小时，访问缓存不会产生额外费用。 | None | None |
+| cache_url | string | No | The URL to access the cached result \| 访问缓存结果的 URL | None | None | None |
+| router | string | No | The endpoint that generated this response \| 生成此响应的端点 | None | None | None |
+| params | dynamic object | No | The parameters used in the request \| 请求中使用的参数 | None | None | None |
+| data | null | No | The response data \| 响应数据 | None | None | None |
+
+<a id="get-api-u1-v1-youtube-web-get-video-comments"></a>
+### `GET /api/u1/v1/youtube/web/get_video_comments`
+
+- Summary: 获取视频评论/Get video comments
+- Capabilities: comments / content details
+- Auth: Header `Authorization: Bearer {token}`; docs also allow Cookie `Authorization` as fallback (`HTTPBearer`)
+- operationId: `get_video_comments_api_v1_youtube_web_get_video_comments_get`
+
+#### Notes
+
+> # [中文]
+> ### 用途:
+> - 获取YouTube视频的一级评论
+>
+> ### 参数详解:
+>
+> #### 📌 必选参数:
+> **video_id** (string)
+> - **作用**: 视频ID
+> - **格式**: YouTube视频ID字符串
+> - **示例**: `"oaSNBz4qMQY"`
+> - **获取方式**: 从URL `https://www.youtube.com/watch?v=oaSNBz4qMQY` 中提取
+>
+> #### ⚙️ 可选参数:
+> **language_code** (string, 可选)
+> - **作用**: 设置评论显示的语言偏好
+> - **默认值**: `"zh-CN"`
+> - **可用值**: `"zh-CN"`, `"en-US"`, `"ja-JP"`, `"ko-KR"` 等
+>
+> **country_code** (string, 可选)
+> - **作用**: 设置地区代码
+> - **默认值**: `"US"`
+> - **可用值**: `"US"`, `"JP"`, `"GB"` 等
+>
+> **sort_by** (string, 可选)
+> - **作用**: 评论排序方式
+> - **默认值**: `"top"`
+> - **可用值**:
+>   - `"top"` - 热门评论（按点赞数排序）
+>   - `"newest"` - 最新评论（按时间排序）
+>
+> **continuation_token** (string, 可选)
+> - **作用**: 翻页令牌，用于获取下一页评论
+> - **默认值**: `null`
+> - **获取方式**: 从上一次请求的响应中提取
+>
+> **need_format** (boolean, 可选)
+> - **作用**: 是否返回清洗后的精简数据
+> - **默认值**: `false`
+> - **可用值**:
+>   - `false` - 返回原始完整数据
+>   - `true` - 返回清洗后的精简数据（推荐）
+>
+> ### 返回数据结构 (need_format=true):
+> ```json
+> {
+>   "comments": [
+>     {
+>       "comment_id": "UgzRDoUJAvDNn5_8i8p4AaABAg",
+>       "content": "评论内容文本",
+>       "published_time": "1天前",
+>       "reply_level": 0,
+>       "like_count": "2",
+>       "like_count_a11y": "2 次赞",
+>       "reply_count": "0",
+>       "reply_count_a11y": "0 条回复",
+>       "reply_count_text": "1 条回复",
+>       "reply_continuation_token": "...",
+>       "author": {
+>         "channel_id": "UCzRzHrLFuH0lHZYnrI84I8Q",
+>         "display_name": "@username",
+>         "channel_url": "https://www.youtube.com/@username",
+>         "avatar_url": "https://yt3.ggpht.com/...",
+>         "avatar_thumbnails": [
+>           {"url": "...", "width": 88, "height": 88}
+>         ],
+>         "is_verified": false,
+>         "is_creator": false,
+>         "is_artist": false
+>       },
+>       "creator_thumbnail_url": "https://yt3.ggpht.com/..."
+>     }
+>   ],
+>   "continuation_token": "下一页token"
+> }
+> ```
+>
+> ### 字段说明:
+> - `comment_id`: 评论唯一ID
+> - `content`: 评论文本内容
+> - `published_time`: 发布时间（相对时间，如"1天前"）
+> - `reply_level`: 回复层级（0表示一级评论）
+> - `like_count`: 点赞数
+> - `reply_count`: 回复数
+> - `reply_count_text`: 回复数文本（如"1 条回复"）
+> - `reply_continuation_token`: 获取该评论回复的token
+> - `author`: 评论作者信息
+>   - `channel_id`: 作者频道ID
+>   - `display_name`: 显示名称
+>   - `channel_url`: 频道URL
+>   - `avatar_url`: 头像URL
+>   - `is_verified`: 是否已认证
+>   - `is_creator`: 是否为视频创作者
+>   - `is_artist`: 是否为音乐人
+> - `creator_thumbnail_url`: 视频创作者头像URL
+>
+> # [English]
+> ### Purpose:
+> - Get YouTube video first-level comments
+>
+> ### Parameters:
+>
+> #### 📌 Required:
+> **video_id** (string)
+> - **Purpose**: Video ID
+> - **Format**: YouTube video ID string
+> - **Example**: `"oaSNBz4qMQY"`
+> - **How to get**: Extract from URL `https://www.youtube.com/watch?v=oaSNBz4qMQY`
+>
+> #### ⚙️ Optional:
+> **language_code** (string, optional)
+> - **Purpose**: Set language preference for comments
+> - **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.
+>
+> **sort_by** (string, optional)
+> - **Purpose**: Comment sorting method
+> - **Default**: `"top"`
+> - **Values**:
+>   - `"top"` - Top comments (sorted by likes)
+>   - `"newest"` - Newest comments (sorted by time)
+>
+> **continuation_token** (string, optional)
+> - **Purpose**: Pagination token for next page
+> - **Default**: `null`
+> - **How to get**: Extract from previous response
+>
+> **need_format** (boolean, optional)
+> - **Purpose**: Whether to return cleaned simplified data
+> - **Default**: `false`
+> - **Values**:
+>   - `false` - Return raw complete data
+>   - `true` - Return cleaned simplified data (recommended)
+>
+> ### Response Structure (need_format=true):
+> ```json
+> {
+>   "comments": [
+>     {
+>       "comment_id": "UgzRDoUJAvDNn5_8i8p4AaABAg",
+>       "content": "Comment text content",
+>       "published_time": "1 day ago",
+>       "reply_level": 0,
+>       "like_count": "2",
+>       "like_count_a11y": "2 likes",
+>       "reply_count": "0",
+>       "reply_count_a11y": "0 replies",
+>       "reply_count_text": "1 reply",
+>       "reply_continuation_token": "...",
+>       "author": {
+>         "channel_id": "UCzRzHrLFuH0lHZYnrI84I8Q",
+>         "display_name": "@username",
+>         "channel_url": "https://www.youtube.com/@username",
+>         "avatar_url": "https://yt3.ggpht.com/...",
+>         "avatar_thumbnails": [
+>           {"url": "...", "width": 88, "height": 88}
+>         ],
+>         "is_verified": false,
+>         "is_creator": false,
+>         "is_artist": false
+>       },
+>       "creator_thumbnail_url": "https://yt3.ggpht.com/..."
+>     }
+>   ],
+>   "continuation_token": "next page token"
+> }
+> ```
+>
+> ### Field Descriptions:
+> - `comment_id`: Unique comment ID
+> - `content`: Comment text content
+> - `published_time`: Published time (relative, e.g., "1 day ago")
+> - `reply_level`: Reply level (0 for first-level comments)
+> - `like_count`: Number of likes
+> - `reply_count`: Number of replies
+> - `reply_count_text`: Reply count text (e.g., "1 reply")
+> - `reply_continuation_token`: Token to get replies for this comment
+> - `author`: Comment author info
+>   - `channel_id`: Author's channel ID
+>   - `display_name`: Display name
+>   - `channel_url`: Channel URL
+>   - `avatar_url`: Avatar URL
+>   - `is_verified`: Whether verified
+>   - `is_creator`: Whether video creator
+>   - `is_artist`: Whether artist
+> - `creator_thumbnail_url`: Video creator's avatar URL
+>
+> # [示例/Examples]
+> ## 获取热门评论
+> GET /youtube_web/get_video_comments?video_id=oaSNBz4qMQY&sort_by=top
+>
+> ## 获取最新评论
+> GET /youtube_web/get_video_comments?video_id=oaSNBz4qMQY&sort_by=newest
+>
+> ## 获取清洗后的评论数据（推荐）
+> GET /youtube_web/get_video_comments?video_id=oaSNBz4qMQY&need_format=true
+>
+> ## 翻页获取更多评论
+> GET /youtube_web/get_video_comments?video_id=oaSNBz4qMQY&continuation_token=xxx&need_format=true
+
+#### Parameters
+
+| Field | In | Type | Required | Description | Default | Example | Enum |
+| --- | --- | --- | --- | --- | --- | --- | --- |
+| video_id | query | string | Yes | 视频ID/Video ID | None | LuIL5JATZsc | None |
+| language_code | query | string | No | 语言代码（如zh-CN, en-US等）/Language code | zh-CN | zh-CN | None |
+| country_code | query | string | No | 国家代码（如US, JP等）/Country code | US | US | None |
+| sort_by | query | string enum[top, newest] | No | 排序方式 \| Sort by | top | None | None |
+| continuation_token | query | string | No | 翻页令牌/Pagination token | None | None | None |
+| need_format | query | boolean | No | 是否需要清洗数据，提取关键内容，移除冗余数据/Whether to clean and format the data | false | None | None |
+
+#### Request Body
+
+None
+
+#### Success Response
+
+##### `200 application/json`
+
+- Schema summary: `code`:integer, `request_id`:string, `message`:string, `message_zh`:string, `support`:string, `time`:string, `time_stamp`:integer, `time_zone`:string, ...
+
+| Field | Type | Required | Description | Default | Example | Enum |
+| --- | --- | --- | --- | --- | --- | --- |
+| code | integer | No | HTTP status code \| HTTP状态码 | 200 | None | None |
+| request_id | string | No | Unique request identifier \| 唯一请求标识符 | None | None | None |
+| message | string | No | Response message (EN-US) \| 响应消息 (English) | Request successful. This request will incur a charge. | None | None |
+| message_zh | string | No | Response message (ZH-CN) \| 响应消息 (中文) | 请求成功，本次请求将被计费。 | None | None |
+| support | string | No | Support message \| 支持消息 | Discord: https://discord.gg/aMEAS8Xsvz | None | None |
+| time | string | No | The time the response was generated \| 生成响应的时间 | None | None | None |
+| time_stamp | integer | No | The timestamp the response was generated \| 生成响应的时间戳 | None | None | None |
+| time_zone | string | No | The timezone of the response time \| 响应时间的时区 | America/Los_Angeles | None | None |
+| docs | string | No | Link to the API Swagger documentation for this endpoint \| 此端点的 API Swagger 文档链接 | None | None | None |
+| cache_message | string | No | Cache message (EN-US) \| 缓存消息 (English) | This request will be cached. You can access the cached result directly using th… | None | None |
+| cache_message_zh | string | No | Cache message (ZH-CN) \| 缓存消息 (中文) | 本次请求将被缓存，你可以使用下面的 URL 直接访问缓存结果，有效期为 24 小时，访问缓存不会产生额外费用。 | None | None |
+| cache_url | string | No | The URL to access the cached result \| 访问缓存结果的 URL | None | None | None |
+| router | string | No | The endpoint that generated this response \| 生成此响应的端点 | None | None | None |
+| params | dynamic object | No | The parameters used in the request \| 请求中使用的参数 | None | None | None |
+| data | null | No | The response data \| 响应数据 | None | None | None |
+
+<a id="get-api-u1-v1-youtube-web-get-video-info"></a>
+### `GET /api/u1/v1/youtube/web/get_video_info`
+
+- Summary: 获取视频信息 V1/Get video information V1
+- Capabilities: content details
+- Auth: Header `Authorization: Bearer {token}`; docs also allow Cookie `Authorization` as fallback (`HTTPBearer`)
+- operationId: `get_video_info_api_v1_youtube_web_get_video_info_get`
+
+#### Notes
+
+> # [中文]
+> ### 用途:
+> - 获取视频元数据及下载信息
+> - 此接口收费: 0.002$/次
+> - 如果需要节省成本，可以使用V2版本，V2版本是0.001$/次，但不保证稳定性。
+> ### 详细参数:
+> - url_access:
+>     - normal: 包含音视频直链
+>     - blocked: 不包含直链
+> - videos/audios:
+>     - auto: 根据url_access自动选择（normal→true，blocked→false）
+>     - true: 返回简化格式信息
+>     - raw: 返回原始格式信息
+>     - false: 不包含该类型数据
+> ### 返回:
+> - 视频元数据 + 请求参数对应的资源信息
+>
+> # [English]
+> ### Purpose:
+> - Get video metadata and download information
+> - This endpoint is charged: 0.002$/request
+> - To save cost, you can use V2 version, which is 0.001$/request, but stability is not guaranteed.
+> ### Parameters Detail:
+> - url_access:
+>     - normal: Include direct URLs
+>     - blocked: Exclude direct URLs
+> - videos/audios:
+>     - auto: Auto-select based on url_access (normal→true，blocked→false)
+>     - true: Simplified format
+>     - raw: Original format
+>     - false: Exclude this type
+> ### Returns:
+> - Video metadata + requested resource information
+>
+> # [示例/Example]
+> video_id = "LuIL5JATZsc"
+> url_access = "blocked"
+> lang = "zh-CN"
+>
+> video_id = "LuIL5JATZsc"
+> url_access = "normal"
+> lang = "en-US"
+> videos = "auto"
+> audios = "auto"
+> subtitles = True
+
+#### Parameters
+
+| Field | In | Type | Required | Description | Default | Example | Enum |
+| --- | --- | --- | --- | --- | --- | --- | --- |
+| video_id | query | string | Yes | 视频ID/Video ID | None | LuIL5JATZsc | None |
+| url_access | query | string enum[normal, blocked] | No | URL访问模式：normal（包含音视频URL）\| blocked（不包含音视频URL） / URL access mode | normal | None | None |
+| lang | query | string | No | 语言代码（IETF标签），默认en-US / Language code | en-US | zh-CN | None |
+| videos | query | string enum[auto, true, raw, false] | No | 视频格式：auto（自动）\| true（简化格式）\| raw（原始格式）\| false（不获取） / Video format selection | auto | None | None |
+| audios | query | string enum[auto, true, raw, false] | No | 音频格式：auto（自动）\| true（简化格式）\| raw（原始格式）\| false（不获取） / Audio format selection | auto | None | None |
+| subtitles | query | boolean | No | 是否获取字幕 / Include subtitles | true | None | None |
+| related | query | boolean | No | 是否获取相关视频 / Include related content | true | None | None |
+
+#### Request Body
+
+None
+
+#### Success Response
+
+##### `200 application/json`
+
+- Schema summary: `code`:integer, `request_id`:string, `message`:string, `message_zh`:string, `support`:string, `time`:string, `time_stamp`:integer, `time_zone`:string, ...
+
+| Field | Type | Required | Description | Default | Example | Enum |
+| --- | --- | --- | --- | --- | --- | --- |
+| code | integer | No | HTTP status code \| HTTP状态码 | 200 | None | None |
+| request_id | string | No | Unique request identifier \| 唯一请求标识符 | None | None | None |
+| message | string | No | Response message (EN-US) \| 响应消息 (English) | Request successful. This request will incur a charge. | None | None |
+| message_zh | string | No | Response message (ZH-CN) \| 响应消息 (中文) | 请求成功，本次请求将被计费。 | None | None |
+| support | string | No | Support message \| 支持消息 | Discord: https://discord.gg/aMEAS8Xsvz | None | None |
+| time | string | No | The time the response was generated \| 生成响应的时间 | None | None | None |
+| time_stamp | integer | No | The timestamp the response was generated \| 生成响应的时间戳 | None | None | None |
+| time_zone | string | No | The timezone of the response time \| 响应时间的时区 | America/Los_Angeles | None | None |
+| docs | string | No | Link to the API Swagger documentation for this endpoint \| 此端点的 API Swagger 文档链接 | None | None | None |
+| cache_message | string | No | Cache message (EN-US) \| 缓存消息 (English) | This request will be cached. You can access the cached result directly using th… | None | None |
+| cache_message_zh | string | No | Cache message (ZH-CN) \| 缓存消息 (中文) | 本次请求将被缓存，你可以使用下面的 URL 直接访问缓存结果，有效期为 24 小时，访问缓存不会产生额外费用。 | None | None |
+| cache_url | string | No | The URL to access the cached result \| 访问缓存结果的 URL | None | None | None |
+| router | string | No | The endpoint that generated this response \| 生成此响应的端点 | None | None | None |
+| params | dynamic object | No | The parameters used in the request \| 请求中使用的参数 | None | None | None |
+| data | null | No | The response data \| 响应数据 | None | None | None |
+
+<a id="get-api-u1-v1-youtube-web-get-video-info-v2"></a>
+### `GET /api/u1/v1/youtube/web/get_video_info_v2`
+
+- Summary: 获取视频信息 V2/Get video information V2
+- Capabilities: content details
+- Auth: Header `Authorization: Bearer {token}`; docs also allow Cookie `Authorization` as fallback (`HTTPBearer`)
+- operationId: `get_video_info_v2_api_v1_youtube_web_get_video_info_v2_get`
+
+#### Notes
+
+> # [中文]
+> ### 用途:
+> - 获取视频元数据及下载信息
+> - 此接口收费: 0.001$/次
+> ### 参数:
+> - video_id: 视频ID，从URL中获取，例如：https://www.youtube.com/watch?v=LuIL5JATZsc，这里的video_id就是LuIL5JATZsc。
+> ### 返回:
+> - 视频元数据 + 请求参数对应的资源信息
+>
+> # [English]
+> ### Purpose:
+> - Get video metadata and download information
+> - This endpoint is charged: 0.001$/request
+> ### Parameters Detail:
+> - video_id: Video ID, get it from the URL, for example: https://www.youtube.com/watch?v=LuIL5JATZsc, the id is LuIL5JATZsc.
+> ### Returns:
+> - Video metadata + requested resource information
+>
+> # [示例/Example]
+> video_id = "LuIL5JATZsc"
+
+#### Parameters
+
+| Field | In | Type | Required | Description | Default | Example | Enum |
+| --- | --- | --- | --- | --- | --- | --- | --- |
+| video_id | query | string | Yes | 视频ID/Video ID | None | LuIL5JATZsc | None |
+
+#### Request Body
+
+None
+
+#### Success Response
+
+##### `200 application/json`
+
+- Schema summary: `code`:integer, `request_id`:string, `message`:string, `message_zh`:string, `support`:string, `time`:string, `time_stamp`:integer, `time_zone`:string, ...
+
+| Field | Type | Required | Description | Default | Example | Enum |
+| --- | --- | --- | --- | --- | --- | --- |
+| code | integer | No | HTTP status code \| HTTP状态码 | 200 | None | None |
+| request_id | string | No | Unique request identifier \| 唯一请求标识符 | None | None | None |
+| message | string | No | Response message (EN-US) \| 响应消息 (English) | Request successful. This request will incur a charge. | None | None |
+| message_zh | string | No | Response message (ZH-CN) \| 响应消息 (中文) | 请求成功，本次请求将被计费。 | None | None |
+| support | string | No | Support message \| 支持消息 | Discord: https://discord.gg/aMEAS8Xsvz | None | None |
+| time | string | No | The time the response was generated \| 生成响应的时间 | None | None | None |
+| time_stamp | integer | No | The timestamp the response was generated \| 生成响应的时间戳 | None | None | None |
+| time_zone | string | No | The timezone of the response time \| 响应时间的时区 | America/Los_Angeles | None | None |
+| docs | string | No | Link to the API Swagger documentation for this endpoint \| 此端点的 API Swagger 文档链接 | None | None | None |
+| cache_message | string | No | Cache message (EN-US) \| 缓存消息 (English) | This request will be cached. You can access the cached result directly using th… | None | None |
+| cache_message_zh | string | No | Cache message (ZH-CN) \| 缓存消息 (中文) | 本次请求将被缓存，你可以使用下面的 URL 直接访问缓存结果，有效期为 24 小时，访问缓存不会产生额外费用。 | None | None |
+| cache_url | string | No | The URL to access the cached result \| 访问缓存结果的 URL | None | None | None |
+| router | string | No | The endpoint that generated this response \| 生成此响应的端点 | None | None | None |
+| params | dynamic object | No | The parameters used in the request \| 请求中使用的参数 | None | None | None |
+| data | null | No | The response data \| 响应数据 | None | None | None |
+
+<a id="get-api-u1-v1-youtube-web-get-video-info-v3"></a>
+### `GET /api/u1/v1/youtube/web/get_video_info_v3`
+
+- Summary: 获取视频详情 V3/Get video information V3
+- Capabilities: content details
+- Auth: Header `Authorization: Bearer {token}`; docs also allow Cookie `Authorization` as fallback (`HTTPBearer`)
+- operationId: `get_video_info_v3_api_v1_youtube_web_get_video_info_v3_get`
+
+#### Notes
+
+> # [中文]
+> ### 用途:
+> - 获取YouTube视频详情信息
+> - 返回原始完整数据（包含 playerResponse 和 initialData）
+>
+> ### 参数详解:
+>
+> #### 📌 必选参数:
+> **video_id** (string)
+> - **作用**: 视频ID
+> - **获取方式**: 从视频URL中提取，例如 `https://www.youtube.com/watch?v=oaSNBz4qMQY`，video_id 就是 `oaSNBz4qMQY`
+> - **示例**: `"oaSNBz4qMQY"`
+>
+> #### ⚙️ 可选参数:
+> **language_code** (string, 可选)
+> - **作用**: 设置语言偏好
+> - **默认值**: `"zh-CN"`
+> - **可用值**: `"zh-CN"`, `"en-US"`, `"ja-JP"`, `"ko-KR"` 等
+>
+> ### 返回数据结构:
+> ```json
+> {
+>   "playerResponse": {
+>     "videoDetails": {},
+>     "streamingData": {
+>       "formats": [],
+>       "adaptiveFormats": []
+>     },
+>     "microformat": {},
+>     ...
+>   },
+>   "initialData": {
+>     "contents": {
+>       "twoColumnWatchNextResults": {
+>         "results": {
+>           "results": {
+>             "contents": [
+>               {
+>                 "videoPrimaryInfoRenderer": {...},
+>                 "videoSecondaryInfoRenderer": {...}
+>               }
+>             ]
+>           }
+>         }
+>       }
+>     },
+>     ...
+>   }
+> }
+> ```
+>
+> ### 主要字段说明:
+> - `playerResponse`: YouTube 播放器响应数据
+>   - `videoDetails`: 视频基本信息（可能为空，取决于YouTube的返回）
+>   - `streamingData`: 视频流数据（包含 formats 和 adaptiveFormats，包含 googlevideo.com 的URL）
+>   - `microformat`: 元数据信息
+> - `initialData`: YouTube 页面初始化数据
+>   - `videoPrimaryInfoRenderer`: 主要信息（标题、观看次数、点赞数等）
+>   - `videoSecondaryInfoRenderer`: 次要信息（频道信息、描述等）
+>
+> # [English]
+> ### Purpose:
+> - Get YouTube video details
+> - Returns raw complete data (includes playerResponse and initialData)
+>
+> ### Parameters:
+>
+> #### 📌 Required:
+> **video_id** (string)
+> - **Purpose**: Video ID
+> - **How to get**: Extract from video URL, e.g., `https://www.youtube.com/watch?v=oaSNBz4qMQY`, video_id is `oaSNBz4qMQY`
+> - **Example**: `"oaSNBz4qMQY"`
+>
+> #### ⚙️ Optional:
+> **language_code** (string, optional)
+> - **Purpose**: Set language preference
+> - **Default**: `"zh-CN"`
+> - **Values**: `"zh-CN"`, `"en-US"`, `"ja-JP"`, `"ko-KR"`, etc.
+>
+> ### Response Structure:
+> ```json
+> {
+>   "playerResponse": {
+>     "videoDetails": {},
+>     "streamingData": {
+>       "formats": [],
+>       "adaptiveFormats": []
+>     },
+>     "microformat": {},
+>     ...
+>   },
+>   "initialData": {
+>     "contents": {
+>       "twoColumnWatchNextResults": {
+>         "results": {
+>           "results": {
+>             "contents": [
+>               {
+>                 "videoPrimaryInfoRenderer": {...},
+>                 "videoSecondaryInfoRenderer": {...}
+>               }
+>             ]
+>           }
+>         }
+>       }
+>     },
+>     ...
+>   }
+> }
+> ```
+>
+> ### Key Fields:
+> - `playerResponse`: YouTube player response data
+>   - `videoDetails`: Basic video info (may be empty depending on YouTube's response)
+>   - `streamingData`: Video stream data (includes formats and adaptiveFormats with googlevideo.com URLs)
+>   - `microformat`: Metadata information
+> - `initialData`: YouTube page initialization data
+>   - `videoPrimaryInfoRenderer`: Primary info (title, view count, like count, etc.)
+>   - `videoSecondaryInfoRenderer`: Secondary info (channel info, description, etc.)
+>
+> # [示例/Examples]
+> ## 获取视频详情数据 / Get video details
+> GET /youtube_web/get_video_info_v3?video_id=oaSNBz4qMQY
+>
+> ## 指定语言 / Specify language
+> GET /youtube_web/get_video_info_v3?video_id=oaSNBz4qMQY&language_code=en-US
+
+#### Parameters
+
+| Field | In | Type | Required | Description | Default | Example | Enum |
+| --- | --- | --- | --- | --- | --- | --- | --- |
+| video_id | query | string | Yes | 视频ID/Video ID | None | oaSNBz4qMQY | None |
+| language_code | query | string | No | 语言代码（如zh-CN, en-US等）/Language code | zh-CN | zh-CN | None |
+
+#### Request Body
+
+None
+
+#### Success Response
+
+##### `200 application/json`
+
+- Schema summary: `code`:integer, `request_id`:string, `message`:string, `message_zh`:string, `support`:string, `time`:string, `time_stamp`:integer, `time_zone`:string, ...
+
+| Field | Type | Required | Description | Default | Example | Enum |
+| --- | --- | --- | --- | --- | --- | --- |
+| code | integer | No | HTTP status code \| HTTP状态码 | 200 | None | None |
+| request_id | string | No | Unique request identifier \| 唯一请求标识符 | None | None | None |
+| message | string | No | Response message (EN-US) \| 响应消息 (English) | Request successful. This request will incur a charge. | None | None |
+| message_zh | string | No | Response message (ZH-CN) \| 响应消息 (中文) | 请求成功，本次请求将被计费。 | None | None |
+| support | string | No | Support message \| 支持消息 | Discord: https://discord.gg/aMEAS8Xsvz | None | None |
+| time | string | No | The time the response was generated \| 生成响应的时间 | None | None | None |
+| time_stamp | integer | No | The timestamp the response was generated \| 生成响应的时间戳 | None | None | None |
+| time_zone | string | No | The timezone of the response time \| 响应时间的时区 | America/Los_Angeles | None | None |
+| docs | string | No | Link to the API Swagger documentation for this endpoint \| 此端点的 API Swagger 文档链接 | None | None | None |
+| cache_message | string | No | Cache message (EN-US) \| 缓存消息 (English) | This request will be cached. You can access the cached result directly using th… | None | None |
+| cache_message_zh | string | No | Cache message (ZH-CN) \| 缓存消息 (中文) | 本次请求将被缓存，你可以使用下面的 URL 直接访问缓存结果，有效期为 24 小时，访问缓存不会产生额外费用。 | None | None |
+| cache_url | string | No | The URL to access the cached result \| 访问缓存结果的 URL | None | None | None |
+| router | string | No | The endpoint that generated this response \| 生成此响应的端点 | None | None | None |
+| params | dynamic object | No | The parameters used in the request \| 请求中使用的参数 | None | None | None |
+| data | null | No | The response data \| 响应数据 | None | None | None |
+
+<a id="get-api-u1-v1-youtube-web-get-video-subtitles"></a>
+### `GET /api/u1/v1/youtube/web/get_video_subtitles`
+
+- Summary: 获取视频字幕/Get video subtitles
+- Capabilities: subtitles / transcription / content details
+- Auth: Header `Authorization: Bearer {token}`; docs also allow Cookie `Authorization` as fallback (`HTTPBearer`)
+- operationId: `api_get_video_subtitles_api_v1_youtube_web_get_video_subtitles_get`
+
+#### Notes
+
+> # [中文]
+> ### 用途:
+> - 获取视频字幕内容
+> ### 使用流程:
+> 1. 先调用获取视频详情接口，从字幕数据中获取subtitleUrl
+> 2. 使用该URL作为本接口参数
+> ### 参数说明:
+> - fix_overlap: 特别适用于自动生成的字幕，会自动分割重叠的时间段
+>
+> # [English]
+> ### Purpose:
+> - Get video subtitle content
+> ### Workflow:
+> 1. First call get_video_info to obtain subtitleUrl
+> 2. Use that URL as parameter here
+> ### Parameter Notes:
+> - fix_overlap: Especially useful for auto-generated subtitles, will split overlapping time ranges
+>
+> # [示例/Example]
+> subtitle_url = "https://www.youtube.com/api/timedtext?v=G33j5Qi4rE8..."
+> target_lang = "zh-CN"
+
+#### Parameters
+
+| Field | In | Type | Required | Description | Default | Example | Enum |
+| --- | --- | --- | --- | --- | --- | --- | --- |
+| subtitle_url | query | string | Yes | 字幕URL（需先调用获取视频详情接口） / Subtitle URL from video details | None | https://www.youtube.com/api/timedtext?v=... | None |
+| format | query | string enum[srt, xml, vtt, txt] | No | 字幕格式：srt/xml/vtt/txt / Subtitle format | srt | None | None |
+| fix_overlap | query | boolean | No | 修复重叠字幕（默认开启） / Fix overlapping subtitles | true | None | None |
+| target_lang | query | string | No | 目标语言代码（留空保持原语言） / Target language code | None | zh-CN | None |
+
+#### Request Body
+
+None
+
+#### Success Response
+
+##### `200 application/json`
+
+- Schema summary: `code`:integer, `request_id`:string, `message`:string, `message_zh`:string, `support`:string, `time`:string, `time_stamp`:integer, `time_zone`:string, ...
+
+| Field | Type | Required | Description | Default | Example | Enum |
+| --- | --- | --- | --- | --- | --- | --- |
+| code | integer | No | HTTP status code \| HTTP状态码 | 200 | None | None |
+| request_id | string | No | Unique request identifier \| 唯一请求标识符 | None | None | None |
+| message | string | No | Response message (EN-US) \| 响应消息 (English) | Request successful. This request will incur a charge. | None | None |
+| message_zh | string | No | Response message (ZH-CN) \| 响应消息 (中文) | 请求成功，本次请求将被计费。 | None | None |
+| support | string | No | Support message \| 支持消息 | Discord: https://discord.gg/aMEAS8Xsvz | None | None |
+| time | string | No | The time the response was generated \| 生成响应的时间 | None | None | None |
+| time_stamp | integer | No | The timestamp the response was generated \| 生成响应的时间戳 | None | None | None |
+| time_zone | string | No | The timezone of the response time \| 响应时间的时区 | America/Los_Angeles | None | None |
+| docs | string | No | Link to the API Swagger documentation for this endpoint \| 此端点的 API Swagger 文档链接 | None | None | None |
+| cache_message | string | No | Cache message (EN-US) \| 缓存消息 (English) | This request will be cached. You can access the cached result directly using th… | None | None |
+| cache_message_zh | string | No | Cache message (ZH-CN) \| 缓存消息 (中文) | 本次请求将被缓存，你可以使用下面的 URL 直接访问缓存结果，有效期为 24 小时，访问缓存不会产生额外费用。 | None | None |
+| cache_url | string | No | The URL to access the cached result \| 访问缓存结果的 URL | None | None | None |
+| router | string | No | The endpoint that generated this response \| 生成此响应的端点 | None | None | None |
+| params | dynamic object | No | The parameters used in the request \| 请求中使用的参数 | None | None | None |
+| data | null | No | The response data \| 响应数据 | None | None | None |
+
+<a id="get-api-u1-v1-youtube-web-search-channel"></a>
+### `GET /api/u1/v1/youtube/web/search_channel`
+
+- Summary: 搜索频道/Search channel
+- Capabilities: search / profiles / accounts
+- Auth: Header `Authorization: Bearer {token}`; docs also allow Cookie `Authorization` as fallback (`HTTPBearer`)
+- operationId: `search_channel_api_v1_youtube_web_search_channel_get`
+
+#### Notes
+
+> # [中文]
+> ### 用途:
+> - 搜索频道。
+> ### 参数:
+> - search_query: 搜索关键字。
+> - language_code: 语言代码，默认为en。
+> - country_code: 国家代码，默认为us。
+> - continuation_token: 用于继续获取搜索结果的令牌。默认为None。
+> ### 返回:
+> - 搜索结果。
+>
+> # [English]
+> ### Purpose:
+> - Search channel.
+> ### Parameters:
+> - search_query: Search keyword.
+> - language_code: Language code, default is en.
+> - country_code: Country code, default is us.
+> - continuation_token: Token to continue fetching search results. Default is None.
+> ### Returns:
+> - Search results.
+>
+> # [示例/Example]
+> channel_id = "UCXuqSBlHAE6Xw-yeJA0Tunw"
+> search_query = "AMD"
+
+#### Parameters
+
+| Field | In | Type | Required | Description | Default | Example | Enum |
+| --- | --- | --- | --- | --- | --- | --- | --- |
+| channel_id | query | string | Yes | 频道ID/Channel ID | None | UCXuqSBlHAE6Xw-yeJA0Tunw | None |
+| search_query | query | string | Yes | 搜索关键字/Search keyword | None | AMD | None |
+| language_code | query | string | No | 语言代码/Language code | en | None | None |
+| country_code | query | string | No | 国家代码/Country code | us | None | None |
+| continuation_token | query | string | No | 翻页令牌/Pagination token | None | None | None |
+
+#### Request Body
+
+None
+
+#### Success Response
+
+##### `200 application/json`
+
+- Schema summary: `code`:integer, `request_id`:string, `message`:string, `message_zh`:string, `support`:string, `time`:string, `time_stamp`:integer, `time_zone`:string, ...
+
+| Field | Type | Required | Description | Default | Example | Enum |
+| --- | --- | --- | --- | --- | --- | --- |
+| code | integer | No | HTTP status code \| HTTP状态码 | 200 | None | None |
+| request_id | string | No | Unique request identifier \| 唯一请求标识符 | None | None | None |
+| message | string | No | Response message (EN-US) \| 响应消息 (English) | Request successful. This request will incur a charge. | None | None |
+| message_zh | string | No | Response message (ZH-CN) \| 响应消息 (中文) | 请求成功，本次请求将被计费。 | None | None |
+| support | string | No | Support message \| 支持消息 | Discord: https://discord.gg/aMEAS8Xsvz | None | None |
+| time | string | No | The time the response was generated \| 生成响应的时间 | None | None | None |
+| time_stamp | integer | No | The timestamp the response was generated \| 生成响应的时间戳 | None | None | None |
+| time_zone | string | No | The timezone of the response time \| 响应时间的时区 | America/Los_Angeles | None | None |
+| docs | string | No | Link to the API Swagger documentation for this endpoint \| 此端点的 API Swagger 文档链接 | None | None | None |
+| cache_message | string | No | Cache message (EN-US) \| 缓存消息 (English) | This request will be cached. You can access the cached result directly using th… | None | None |
+| cache_message_zh | string | No | Cache message (ZH-CN) \| 缓存消息 (中文) | 本次请求将被缓存，你可以使用下面的 URL 直接访问缓存结果，有效期为 24 小时，访问缓存不会产生额外费用。 | None | None |
+| cache_url | string | No | The URL to access the cached result \| 访问缓存结果的 URL | None | None | None |
+| router | string | No | The endpoint that generated this response \| 生成此响应的端点 | None | None | None |
+| params | dynamic object | No | The parameters used in the request \| 请求中使用的参数 | None | None | None |
+| data | null | No | The response data \| 响应数据 | None | None | None |
+
+<a id="get-api-u1-v1-youtube-web-search-video"></a>
+### `GET /api/u1/v1/youtube/web/search_video`
+
+- Summary: 搜索视频/Search video
+- Capabilities: search / content details
+- Auth: Header `Authorization: Bearer {token}`; docs also allow Cookie `Authorization` as fallback (`HTTPBearer`)
+- operationId: `search_video_api_v1_youtube_web_search_video_get`
+
+#### Notes
+
+> # [中文]
+> ### 用途:
+> - 搜索视频。
+> ### 参数:
+> - search_query: 搜索关键字。
+> - language_code: 语言代码，默认为en。
+> - order_by: 排序方式，默认为this_month，可选值为this_week, this_month, this_year, last_hour, today。
+> - country_code: 国家代码，默认为us。
+> - continuation_token: 用于继续获取搜索结果的令牌。默认为None。
+> ### 返回:
+> - 搜索结果。
+>
+> # [English]
+> ### Purpose:
+> - Search video.
+> ### Parameters:
+> - search_query: Search keyword.
+> - language_code: Language code, default is en.
+> - order_by: Order by, default is this_month, optional values are this_week, this_month, this_year, last_hour, today.
+> - country_code: Country code, default is us.
+> - continuation_token: Token to continue fetching search results. Default is None.
+> ### Returns:
+> - Search results.
+>
+> # [示例/Example]
+> search_query = "Minecraft"
+
+#### Parameters
+
+| Field | In | Type | Required | Description | Default | Example | Enum |
+| --- | --- | --- | --- | --- | --- | --- | --- |
+| search_query | query | string | Yes | 搜索关键字/Search keyword | None | Minecraft | None |
+| language_code | query | string | No | 语言代码/Language code | en | None | None |
+| order_by | query | string | No | 排序方式/Order by | this_month | None | None |
+| country_code | query | string | No | 国家代码/Country code | us | None | None |
+| continuation_token | query | string | No | 翻页令牌/Pagination token | None | None | None |
+
+#### Request Body
+
+None
+
+#### Success Response
+
+##### `200 application/json`
+
+- Schema summary: `code`:integer, `request_id`:string, `message`:string, `message_zh`:string, `support`:string, `time`:string, `time_stamp`:integer, `time_zone`:string, ...
+
+| Field | Type | Required | Description | Default | Example | Enum |
+| --- | --- | --- | --- | --- | --- | --- |
+| code | integer | No | HTTP status code \| HTTP状态码 | 200 | None | None |
+| request_id | string | No | Unique request identifier \| 唯一请求标识符 | None | None | None |
+| message | string | No | Response message (EN-US) \| 响应消息 (English) | Request successful. This request will incur a charge. | None | None |
+| message_zh | string | No | Response message (ZH-CN) \| 响应消息 (中文) | 请求成功，本次请求将被计费。 | None | None |
+| support | string | No | Support message \| 支持消息 | Discord: https://discord.gg/aMEAS8Xsvz | None | None |
+| time | string | No | The time the response was generated \| 生成响应的时间 | None | None | None |
+| time_stamp | integer | No | The timestamp the response was generated \| 生成响应的时间戳 | None | None | None |
+| time_zone | string | No | The timezone of the response time \| 响应时间的时区 | America/Los_Angeles | None | None |
+| docs | string | No | Link to the API Swagger documentation for this endpoint \| 此端点的 API Swagger 文档链接 | None | None | None |
+| cache_message | string | No | Cache message (EN-US) \| 缓存消息 (English) | This request will be cached. You can access the cached result directly using th… | None | None |
+| cache_message_zh | string | No | Cache message (ZH-CN) \| 缓存消息 (中文) | 本次请求将被缓存，你可以使用下面的 URL 直接访问缓存结果，有效期为 24 小时，访问缓存不会产生额外费用。 | None | None |
+| cache_url | string | No | The URL to access the cached result \| 访问缓存结果的 URL | None | None | None |
+| router | string | No | The endpoint that generated this response \| 生成此响应的端点 | None | None | None |
+| params | dynamic object | No | The parameters used in the request \| 请求中使用的参数 | None | None | None |
+| data | null | No | The response data \| 响应数据 | None | None | None |