频道资料 API
用频道 ID、频道链接或 @handle 查询频道,返回名称、简介、头像、订阅数、视频数和总播放量。
查询 YouTube 频道资料。channel_id(UC 开头)、频道链接(/channel/UC… 或 /@handle)、handle 三选一。
返回频道名、简介、头像、横幅、国家、创建时间、订阅数 follower、视频数和总播放量。投稿列表请用频道视频接口。
请求地址 POST https://www.xmedi.cn/api/v1/youtube/channels/profile。调用成功才扣费,参数错误、平台侧失败或超时不扣费。
成功响应的 meta 含数据血缘,说明见 鉴权与计费。
适用场景
- 达人评估:看订阅数、视频数和总播放再决定是否合作。
- 入库:用频道 ID 作为主键,定期刷新订阅数。
- 跳转:拿到 channel_id 后拉该频道的视频、Shorts 或直播。
请求参数
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
channel_id |
string | 否 | 频道 ID,UC 开头 24 位。与 channel_url、handle 三选一。 |
channel_url |
string | 否 | 频道链接,/channel/UC… 或 /@handle 都可以。 |
handle |
string | 否 | 频道 @handle,可带或不带 @。 |
返回 data 字段
| 字段 | 类型 | 说明 |
|---|---|---|
avatar | string | |
banner | string | |
country | string | |
created_at | string | |
description | string | 简介。 |
follower | number | 订阅数。 |
id | string | 频道 ID。 |
nickname | string | 频道名称。 |
url | string | 频道链接。 |
verified | boolean | |
video_count | number | 视频数。 |
view_count | number | 总播放量。 |
调用示例
curl -X POST https://www.xmedi.cn/api/v1/youtube/channels/profile \
-H "X-XMEDI-Key: xm_live_xxxxxxxx" \
-H "Content-Type: application/json" \
-d '{"channel_id":"UCX6OQ3DkcsbYNE6H8uQQuVA"}'
返回示例
以下为 data 的字段结构示意,实际取值以调用结果为准。
{
"avatar": "https://example.com/avatar.jpg",
"description": "示例简介",
"follower": 100000,
"id": "UCxxxxxxxxxxxxxxxxxxxxxx",
"nickname": "示例频道",
"url": "https://www.youtube.com/channel/UCxxxxxxxxxxxxxxxxxxxxxx",
"verified": false,
"video_count": 120,
"view_count": 5000000
}
注意事项
- follower 是订阅数,不是单条视频的播放量。
- 本接口不返回视频列表。
常见错误码
| code | error_code | 含义与处理 |
|---|---|---|
| 40001 | VALIDATION_ERROR | 参数校验失败,按返回提示修改请求,不扣费 |
| 40100 | UNAUTHORIZED | API Key 缺失、错误或已吊销,到控制台检查 Key |
| 40200 | INSUFFICIENT_BALANCE | 余额不足,充值后重试 |
| 42900 | RATE_LIMITED | 超过每分钟 60 次上限,稍后重试 |
| 50000 | INTERNAL_ERROR | 服务异常,可稍后重试,不扣费 |
| 50300 | NOT_AVAILABLE | 接口暂不可用,不扣费 |
常见问题
- @handle 怎么传?
- 传 handle,或传带 /@handle 的频道链接。不要把视频链接当成频道链接。
- 能看到频道里的视频吗?
- 不能。拿到 id 后用频道视频、Shorts 或直播接口。
- 调用失败会扣费吗?
- 频道不存在或三种入参都没传时不扣费。
相关接口
需要接入这个接口?
免费注册
注册后创建 API Key,或留下联系方式获取方案