按频道登录名获取 Twitch 频道公开的往期直播回放视频列表
查看 Twitch 频道、剪辑、视频与直播数据 API 的全部接口 →按频道登录名查询某个 Twitch 频道当前可获取的公开视频(往期直播回放)合集。必填参数 channel(例如 ninja);翻页时再传可选的数字型 cursor,该值必须来自同一频道上一次响应返回的继续翻页值。响应统一包装为 {status, request_id, message, data},具体记录位于 data.user 下。 以频道 ninja 做实时探测时观察到:data.user.id(频道 ID)、data.user.videos(每页 12 条 edge)以及 data.user.cursor(整数,第一页为 2),后者是页面级的继续翻页值。每条 edge 包含一个不透明的 cursor 字符串和一个 node,node 内含 id、title、publishedAt(ISO 8601 UTC 时间)、lengthSeconds、viewCount、previewThumbnailURL、animatedPreviewURL、game(id、name、displayName、slug、boxArtURL)、owner(id、login、displayName、profileImageURL、primaryColorHex、roles.isPartner)、self.isRestricted、resourceRestriction 以及 contentTags。在这次探测中,视频按发布时间从新到旧排列,resourceRestriction 为 null,contentTags 为空列表;这两个字段有值时的情况、第二页内容以及合集末尾的表现均未观察到。 翻页方式:第一次请求不要传 cursor,保持 channel 不变,原样使用返回的继续翻页值,当该值缺失或重复出现时停止,并按视频 id 去重。适用范围:响应反映的是当前可获取的视频记录,并非完整的历史存档;已删除、已过期或受限制的录像可能不会出现。该接口只返回元数据和图片链接,不会下载媒体文件。
API 功能
在线 API 演示
未找到可用的 API Key,请前往控制台创建后刷新本页。 控制台 →
/api/project/twitch-scraper/list-channel-videos API 响应 (JSON)
{} curl -X GET 'https://api.opendata-api.com/api/project/twitch-scraper/list-channel-videos?key=<API_KEY>&channel=ninja'
查询结果
使用场景
- 对比多页视频的 publishedAt 时间戳,评估某位主播发布往期直播回放的频率。
- 为电竞组织建立 VOD 清单,查看旗下各频道的赛事直播回放目前还有哪些仍在列表中。
- 为二次剪辑流水线提供每位主播最新的视频 id 与标题,只使用元数据,不下载媒体文件。
- 把同一频道的视频合集与剪辑合集对照,估算其内容有多少被观众剪成了短片段。
- 按 viewCount 和 lengthSeconds 对创作者近期的录像排序,找出能留住观众的游戏与内容形式。
- 沿着游标链逐页读取某个频道,按视频 id 去重,并将覆盖范围表述为“可获取的记录”而非完整存档。
常见问题
获取频道视频列表的接口会返回什么?
它返回某个 Twitch 频道当前可获取的公开往期直播视频。以频道 ninja 做实时探测时,data.user.videos 包含 12 条 edge,每条都有一个 cursor 字符串和一个 node,node 中含有 id、title、publishedAt、lengthSeconds、viewCount、预览图链接、game、owner 以及限制相关字段。
如何获取下一页视频?
第一次请求不要传 cursor。后续翻页时,带上相同的 channel,并原样传入上一次响应中页面级的 data.user.cursor 值。探测中该值是整数(第一页为 2),与数字型的 cursor 参数一致。当该值缺失或重复出现时停止,并按视频 id 去重。
可以直接使用每条视频 edge 上的 cursor 字符串吗?
不可以。探测中看到的每条 edge 的 cursor 是不透明的、以竖线分隔的字符串,而 cursor 参数是数字型的。请改用页面级的 data.user.cursor 值。
它会返回频道历史上直播过的所有内容吗?
不会。响应反映的是当前可获取的视频记录,并非完整的历史存档。已删除、已过期或受限制的录像可能不会出现,因此你统计出的总数只代表可获取视频的覆盖情况。
这个接口会下载或推流视频文件吗?
不会。它只返回元数据以及 previewThumbnailURL、animatedPreviewURL 等图片链接,不会获取、存储或转码录像本身。
频道的“视频”和“剪辑”有什么区别?
视频是该频道的往期直播录像,而剪辑是由频道剪辑接口提供的另一个独立合集。两者都按频道使用游标分页,所以请分别调用,如果两者都需要,请在你自己的系统中合并结果。
查询不存在的频道或没有视频的频道会怎样?
这种情况探测中没有覆盖,探测只使用了频道 ninja,因此确切的响应尚未验证。请检查 status 和 message 字段,并对空的或缺失的 data.user.videos 列表做好防御性处理。
数据是实时的还是快照?
每次响应都是对公开视频合集的一次时点读取,因此 viewCount 等数值在两次调用之间可能发生变化。如需查看直播状态,请改用独立的直播流相关接口。