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

同时在线观众快照 传入频道登录名,即可获得该频道当前直播在请求时刻的观看人数信息,无需注册 Twitch 开发者应用,也不用刷新令牌。
缺失值不等于零 实测离线频道返回 status 'ok',data.user.stream 为 null 且没有观看人数,所以离线样本可以存成 NULL,而不是记录成错误的 0。
不是粉丝数,也不是视频播放量 该数字只描述当前这场直播的实时观众,与频道详情里的粉丝总数以及历史视频播放量互相独立,建模时请分开存放。
请求简单,适合定时采样 只有一个必填的字符串参数,data.user 载荷也很小,用定时任务对整份主播名单调用成本很低,可直接写入频道、时间戳和数值三列。
时间序列由你自己积累 接口不返回观众历史,峰值、平均值和趋势都要靠你采集的快照来计算,并为每条快照标注自己的检索时间。

在线 API 演示

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

使用场景

常见问题

频道离线时,观看人数接口返回什么?

对频道 ninja 的实测中频道处于离线状态,响应为 status 'ok'、message 为 null、data.user.stream 为 null。响应里没有观看人数,请把它当作“不可用”,而不是 0。

频道直播时,观看人数字段叫什么?

实测中没有出现正在直播时的完整返回,所以这里不列出字段名。请在频道开播期间调用一次,从 data.user.stream 中读取该字段,再设计你的数据表结构。

离线时的样本应该怎么记录?

连同检索时间一起存成 NULL(或单独加一个离线标记)。请把缺失或不可用的值与数字 0 区分开,因为记成 0 就等于声称一场正在进行的直播没有任何观众。

它和总播放量或粉丝数是一回事吗?

不是。它反映的是当前这场直播的观众数量,不同于历史视频播放量,也不同于“获取频道详情”返回的粉丝总数,请分别放在不同的列里。

能用这个接口获取观看人数的历史或时间序列吗?

不能。它只是请求时刻的快照,不提供历史观众趋势。请按自己的节奏轮询,并把每次结果与检索时间一起保存。

观看人数是实时更新的吗?

请把它当作调用瞬间的时点数值。频道离线状态或 Twitch 的可用性都可能影响结果,所以请按适合业务的间隔采样,不要假设两次调用之间的数据是连续的。

channel 参数应该传什么?

传公开 Twitch 网址中显示的频道登录名,例如 ninja。如果只知道展示名称,请先用“搜索频道”接口找到登录名,再在这里沿用。

相关接口

相关指南

查看订阅方案 →