按登录名获取 Twitch 直播实时观看人数
查看 Twitch 频道、剪辑、视频与直播数据 API 的全部接口 →返回某个 Twitch 频道当前直播可用的观看人数信息,是请求时刻的一次快照。输入参数:channel(必填)是公开 Twitch 网址中显示的频道登录名,例如 ninja,而不是展示用的标题。以频道 ninja 离线时的一次实测为例:返回 HTTP 200,使用统一的外层结构 {status, request_id, message, data};status 为 'ok',message 为 null,data.user 包含字符串类型的 id、值为 null 的 stream 以及 __typename 'User'。stream 为 null 时响应中没有观看人数,这是有效结果。实测中没有出现正在直播时的完整返回,因此这里不列出观看人数字段的名称;映射前请先查看真实开播频道的响应,并把“没有数值”与数字 0 区分开。该数字表示当前这场直播的观众数量,不同于历史视频的播放量,也不同于频道粉丝总数。接口不提供观众历史或时间序列,请在每条快照上记录你自己的检索时间。
API 功能
在线 API 演示
未找到可用的 API Key,请前往控制台创建后刷新本页。 控制台 →
/api/project/twitch-scraper/get-stream-viewer-count API 响应 (JSON)
{} curl -X GET 'https://api.opendata-api.com/api/project/twitch-scraper/get-stream-viewer-count?key=<API_KEY>&channel=ninja'
查询结果
使用场景
- 每隔几分钟写入一行(频道、时间戳、观看人数),之后再计算观众峰值与平均值
- 核对赞助时段:在约定窗口内对主播的观看人数采样,离线样本保留为 NULL
- 当被追踪频道的观看人数快照明显高于近期样本时,触发观众激增提醒
- 按最新观看人数快照对一小批被追踪主播排名,并把离线频道单独放在另一个分区
- 设计数据表结构,把直播实时观众与历史视频播放量、频道粉丝总数分开存放
常见问题
频道离线时,观看人数接口返回什么?
对频道 ninja 的实测中频道处于离线状态,响应为 status 'ok'、message 为 null、data.user.stream 为 null。响应里没有观看人数,请把它当作“不可用”,而不是 0。
频道直播时,观看人数字段叫什么?
实测中没有出现正在直播时的完整返回,所以这里不列出字段名。请在频道开播期间调用一次,从 data.user.stream 中读取该字段,再设计你的数据表结构。
离线时的样本应该怎么记录?
连同检索时间一起存成 NULL(或单独加一个离线标记)。请把缺失或不可用的值与数字 0 区分开,因为记成 0 就等于声称一场正在进行的直播没有任何观众。
它和总播放量或粉丝数是一回事吗?
不是。它反映的是当前这场直播的观众数量,不同于历史视频播放量,也不同于“获取频道详情”返回的粉丝总数,请分别放在不同的列里。
能用这个接口获取观看人数的历史或时间序列吗?
不能。它只是请求时刻的快照,不提供历史观众趋势。请按自己的节奏轮询,并把每次结果与检索时间一起保存。
观看人数是实时更新的吗?
请把它当作调用瞬间的时点数值。频道离线状态或 Twitch 的可用性都可能影响结果,所以请按适合业务的间隔采样,不要假设两次调用之间的数据是连续的。
channel 参数应该传什么?
传公开 Twitch 网址中显示的频道登录名,例如 ninja。如果只知道展示名称,请先用“搜索频道”接口找到登录名,再在这里沿用。