YouTube — 频道视频
SpiderHubs OpenAPI 文档:YouTube — 频道视频,分类 YouTube。接口 GET /openapi/v1/contentcreator/youtube/web_v2/get_channel_videos。按 channel_id 读取频道视频列表。首页带频道资料;翻页时 chann...
OpId:
yt-channel-videos · 最近更新: 2026-11-19说明
按 channel_id 读取频道视频列表。首页带频道资料;翻页时 channel 字段不再返回,请自己记下首页的频道资料。列表里的地址是观看页。即使响应里出现短时播放地址,也不能当作可保存的视频文件。
基础信息
- Endpoint:
- GET /openapi/v1/contentcreator/youtube/web_v2/get_channel_videos
- 计费:
- 1 积分 / 次
- 限流:
- 300 次 / 分钟 / 用户
请求参数说明
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| channel_id | string | 是 | 频道 ID。可用「频道 ID」接口从 @用户名链接换取 |
| continuation_token | string | 否 | 翻页令牌。首页不传 |
| language_code | string | 否 | 显示语言,默认 zh-CN |
| country_code | string | 否 | 地区,默认 US |
| need_format | boolean | 否 | 是否返回清洗后的列表。默认 true |
响应字段说明
| 字段 | 类型 | 说明 |
|---|---|---|
| code | int | 业务状态码,200 表示成功 |
| request_id | string | 本次请求唯一标识,排查问题时可提供 |
| data | object | 业务数据容器,具体字段见下 |
| data.channel | object | 仅首页返回。含 id、name、description、url、is_verified |
| data.videos | array | 视频列表 |
| data.videos[].video_id | string | 视频 ID |
| data.videos[].title | string | 标题 |
| data.videos[].url | string | 观看页链接 |
| data.videos[].duration | string | 时长,如 16:57 |
| data.videos[].view_count | string | 播放量文案 |
| data.videos[].published_time | string | 相对发布时间 |
| data.continuation_token | string | 下一页令牌 |
请求示例 · cURL
curl 'https://api.spiderhubs.com/openapi/v1/contentcreator/youtube/web_v2/get_channel_videos?channel_id=UCBR8-60-B28hp2BmDPdntcQ' \
-H 'Authorization: Bearer sk_live_xxxxxxxxxxxxxxxxxxxxxxxx'响应示例
{
"code": 200,
"request_id": "d9021bb4-6c33-4e18-a771-90ac4f12de08",
"data": {
"channel": {
"id": "UCBR8-60-B28hp2BmDPdntcQ",
"name": "YouTube",
"url": "https://www.youtube.com/channel/UCBR8-60-B28hp2BmDPdntcQ",
"is_verified": true
},
"videos": [
{
"video_id": "ZFEnfscZpAU",
"title": "Example title",
"url": "https://www.youtube.com/watch?v=ZFEnfscZpAU",
"duration": "0:42",
"view_count": "1,200 views",
"published_time": "2 days ago"
}
],
"continuation_token": ""
}
}开始调用 SpiderHubs API
使用账户中心生成的 API Key,通过 Authorization: Bearer sk_live_xxx 调用接口。