按登录名获取 Twitch 频道精彩片段列表
查看 Twitch 频道、剪辑、视频与直播数据 API 的全部接口 →返回某个 Twitch 频道的公开精彩片段(Clips),结果为支持游标翻页的集合,与该频道的视频和直播数据相互独立。输入参数:channel(必填)是公开 Twitch 网址中显示的频道登录名,例如 ninja,而不是展示用的标题;cursor(可选,数字)是同一频道上一次响应返回的续页游标,首次请求时不要传。以频道 ninja 的一次实测为例:响应使用统一的外层结构 {status, request_id, message, data},status 为 'ok',message 为 null;data.user 包含频道 id、一个含 12 条记录的 clips 数组,以及顶层 cursor(实测为整数)。clips 中的每一项形如 {cursor, node},前 11 项的单条 cursor 为 null,最后一项为字符串。每个 node 包含 id、slug、url、embedURL、title、viewCount、language、thumbnailURL、createdAt、durationSeconds 和 isFeatured,并嵌套 curator(id、login、displayName)、game(id、slug、name、boxArtURL)、broadcast(id、startedAt、title)以及 broadcaster(id、login、displayName、profileImageURL、primaryColorHex、roles)对象;champBadge 和 guestStarParticipants 为 null。以上字段名来自单次实测,不保证每条片段都有;用游标翻到下一页的行为在实测中没有验证。片段的可用性会随时间变化:返回结果不代表可以下载媒体文件或永久可访问,也不应认为列表包含该频道的全部历史片段。
API 功能
在线 API 演示
未找到可用的 API Key,请前往控制台创建后刷新本页。 控制台 →
/api/project/twitch-scraper/list-channel-clips API 响应 (JSON)
{} curl -X GET 'https://api.opendata-api.com/api/project/twitch-scraper/list-channel-clips?key=<API_KEY>&channel=ninja'
查询结果
使用场景
- 为周度精彩集锦挑选被追踪主播的新片段,用于通讯邮件或社媒发布队列
- 收集赞助推广周期前后的片段标题和创建时间,作为品牌曝光的佐证材料
- 把团队频道新产生的片段送入审核或社区运营的复核队列
- 跨多个游标页按片段 id 去重,并在续页游标重复出现时停止翻页
- 在内容发现页上展示每个频道最新的 12 条片段,并链接回原片段
常见问题
获取片段列表时,channel 参数应该传什么?
传公开 Twitch 网址中显示的频道登录名,例如 ninja。展示标题或随意输入的名称都不是登录名;如果只知道名字,请先用「搜索频道」接口,再从结果里取登录名。
如何翻页获取更多片段?
首次请求不要传 cursor。实测响应在 data.user 下、clips 数组旁带有一个顶层 cursor(整数);把上一次响应的续页游标原样连同相同的 channel 传回即可,游标缺失或重复时就停止。不过翻到下一页的请求本身在实测中没有验证过。
一次请求返回多少条片段?
对频道 ninja 的实测返回了 12 条片段。该接口没有页大小参数,所以每页大约按十几条来规划。
每条片段里的 cursor 可以用来翻页吗?
不建议依赖。实测中 clips 各项内部的 cursor,前 11 项为 null,最后一项是字符串;而 data.user 上的顶层 cursor 是与数字型 cursor 参数对应的整数。
列表会包含频道历史上的所有片段吗?
不会。请把它当作接口在请求时刻提供的集合。片段可能被删除或变得不可用,返回结果也不保证可下载媒体或永久可访问,不应把列表当作完整的历史记录。
哪些字段能标识片段并说明是谁制作的?
用 node.id、node.slug、node.url 和 node.embedURL 标识并链接片段,用 node.curator 表示创建片段的账号,用 node.broadcaster 表示被剪辑的频道,用 node.game 表示正在玩的分类。
调用时需要 Twitch 开发者账号或访问令牌吗?
不需要。请求只需要本服务的 API 密钥和频道登录名,你不必注册 Twitch 应用,也不用自己刷新 Twitch 令牌。