[中文]

用途:

获取YouTube频道的视频列表

支持分页获取，可通过 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):

{
  "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

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):

{
  "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?channel_id=UCJHBJ7F-nAIlMGolm0Hu4vg

获取清洗后的数据（推荐）/ Get cleaned data (recommended)

GET /youtube_web/get_channel_videos?channel_id=UCJHBJ7F-nAIlMGolm0Hu4vg&need_format=true

获取下一页 / Get next page

GET /youtube_web/get_channel_videos?channel_id=UCJHBJ7F-nAIlMGolm0Hu4vg&continuation_token=xxxxx&need_format=true

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200

application/json

Successful Response

Body

Example

{
    "code": 200,
    "request_id": "string",
    "message": "Request successful. This request will incur a charge.",
    "message_zh": "请求成功，本次请求将被计费。",
    "support": "Discord: https://discord.gg/aMEAS8Xsvz",
    "time": "string",
    "time_stamp": 0,
    "time_zone": "America/Los_Angeles",
    "docs": "string",
    "cache_message": "string",
    "cache_message_zh": "string",
    "cache_url": "string",
    "router": "",
    "params": {},
    "data": null
}

🟠422

获取频道视频 /Get channel videos

[中文]#

用途:#

参数详解:#

📌 必选参数:#

⚙️ 可选参数:#

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

清洗后的字段说明:#

[English]#

Purpose:#

Parameters:#

📌 Required:#

⚙️ Optional:#

Response Structure (need_format=true):#

Cleaned Data Field Descriptions:#

[示例/Examples]#

获取频道首页视频 / Get first page of channel videos#

获取清洗后的数据（推荐）/ Get cleaned data (recommended)#

获取下一页 / Get next page#

Request