欢迎访问极媒数据 · 新媒体数据服务平台 登录 免费注册 控制台
新媒体数据
服务平台

频道资料 API

youtube¥0.15/次每分钟 60 次

用频道 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 字段

字段类型说明
avatarstring
bannerstring
countrystring
created_atstring
descriptionstring简介。
followernumber订阅数。
idstring频道 ID。
nicknamestring频道名称。
urlstring频道链接。
verifiedboolean
video_countnumber视频数。
view_countnumber总播放量。

调用示例

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 是订阅数,不是单条视频的播放量。
  • 本接口不返回视频列表。

常见错误码

codeerror_code含义与处理
40001VALIDATION_ERROR参数校验失败,按返回提示修改请求,不扣费
40100UNAUTHORIZEDAPI Key 缺失、错误或已吊销,到控制台检查 Key
40200INSUFFICIENT_BALANCE余额不足,充值后重试
42900RATE_LIMITED超过每分钟 60 次上限,稍后重试
50000INTERNAL_ERROR服务异常,可稍后重试,不扣费
50300NOT_AVAILABLE接口暂不可用,不扣费

常见问题

@handle 怎么传?
传 handle,或传带 /@handle 的频道链接。不要把视频链接当成频道链接。
能看到频道里的视频吗?
不能。拿到 id 后用频道视频、Shorts 或直播接口。
调用失败会扣费吗?
频道不存在或三种入参都没传时不扣费。

相关接口

需要接入这个接口?

注册后创建 API Key,或留下联系方式获取方案

免费注册
×

微信号 xmedi369