按登录名获取 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 功能

按频道登录名取片段 传入 ninja 这样的频道登录名,一次 GET 请求即可拿到该频道的公开片段,无需注册 Twitch 开发者应用,也不用管理 client-credentials 令牌。
片段标识与链接 每个片段节点都带有 id、slug、url 和 embedURL,方便跳转回原片段或直接嵌入页面,也可以把片段 id 作为稳定的存储主键。
互动与时间字段 每条片段都返回 viewCount、durationSeconds、createdAt、language、isFeatured 和 thumbnailURL,无需额外查询就能完成排序、筛选和按日期归档。
游戏、剪辑者与主播上下文 嵌套的 game(名称、slug、封面图)、curator(谁剪辑的)、broadcast(标题和开播时间)以及 broadcaster 对象,说明了片段玩的是什么、出自谁的直播。
游标分页回溯更早内容 首次请求不传 cursor,之后把上一次响应里的续页游标连同相同的 channel 一起传回,即可继续往前翻;实测每页返回 12 条片段。

在线 API 演示

GET /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'
📢
需要帮助?
如遇接口异常,或需要其他接口需求,可联系我们
联系我们

使用场景

常见问题

获取片段列表时,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 令牌。

相关接口

相关指南

查看订阅方案 →