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

按频道登录名获取往期直播记录 只需传入一个频道登录名,一次调用即可拿到该 Twitch 频道的公开视频合集,无需自行注册开发者应用,也不用处理令牌。
每个节点自带核心回放指标 每个视频节点都包含 id、title、publishedAt、lengthSeconds 和 viewCount,足以按场次衡量更新频率、录像时长和观众规模。
静态与动态预览图链接 previewThumbnailURL 和 animatedPreviewURL 提供可直接用于视频墙和数据看板的图片链接;接口只给出图片地址,不会下载或推流任何媒体。
每段录像关联所属游戏 game 对象(id、name、displayName、slug、boxArtURL)说明了每场直播玩的是什么、聊的是什么,便于按游戏分类对视频分组。
附带合作伙伴标记的频道主信息 每个节点都会重复返回 owner(id、login、displayName、profileImageURL、primaryColorHex 以及 roles.isPartner),无需再额外查询频道,就能确认视频归属。
视频列表的继续翻页值 每页返回 12 条视频,并附带页面级的 data.user.cursor;将它与相同的 channel 一起原样传回即可继续翻页,缺失或重复出现时即可停止。

在线 API 演示

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

使用场景

常见问题

获取频道视频列表的接口会返回什么?

它返回某个 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 等数值在两次调用之间可能发生变化。如需查看直播状态,请改用独立的直播流相关接口。

相关接口

相关指南

查看订阅方案 →