导入
活跃流
学习如何获取 Twitch 上所有正在进行的直播流列表。
大多数用户访问 Twitch 的主要目的是观看直播流。事实上，当我们进入 Twitch 时，首页会显示多个正在直播的流。只需点击一下即可开始观看。
Twitch API 也可以用来获取类似的直播流列表。我们可以通过向 Twitch API 的 streams 端点发送 GET 请求，来获取当前所有正在直播的流列表。
![streams 端点概览](http://network.jancsitech.net:9000/pageflex-ai/images/general/202509/1758261290899857816.svg "An overview of the streams endpoint" width="600" height="400")
代码示例
1https://api.twitch.tv/helix/streams
| 参数 | 类型 | 分类 | 描述 |
|---|---|---|---|
| after | 字符串 | 可选 | 用于向前分页的游标值。每次从 streams 端点返回多页结果时，都会提供一个游标值。我们可以将该值放入 after 参数中，以获取游标指定页面之后的下一页结果。 |
| before | 字符串 | 可选 | 用于向后分页的游标值。每次从 streams 端点返回多页结果时，都会提供一个游标值。我们可以将该值放入 before 参数中，以获取游标指定页面之前的上一页结果。 |
| first | 整数 | 可选 | 每页返回的流数量，每页最多 100 条结果，默认值为 20。 |
| game_id | 字符串 | 可选 | 根据指定的游戏 ID 过滤返回的流。最多可提供 100 个游戏 ID。 |
| language | 字符串 | 可选 | 使用 ISO-639-1 语言代码过滤结果。最多可提供 100 个语言代码。 |
| user_id | 字符串 | 可选 | 根据指定的用户 ID 过滤返回的流。最多可提供 100 个用户 ID。 |
| user_login | 字符串 | 可选 | 此参数与 user_id 类似，根据指定的用户登录名过滤返回的流。最多可提供 100 个登录名。 |
1headers = { 2 'Authorization': 'Bearer {{APP_ACCESS_TOKEN}}', 3 'Client-Id': '{{CLIENT_ID}}' 4} 5 6response = requests.get('https://api.twitch.tv/helix/streams', headers=headers).json() 7 8print(json.dumps(response, indent=4))
| 属性 | 类型 | 描述 |
|---|---|---|
| id | 字符串 | 直播流的唯一标识 ID。 |
| user_id | 字符串 | 直播用户的唯一标识 ID。 |
| user_login | 字符串 | 直播用户的登录名。 |
| user_name | 字符串 | 直播用户的显示名称。 |
| game_id | 字符串 | 直播中正在玩的游戏的 ID。 |
| game_name | 字符串 | 直播中正在玩的游戏名称。 |
| type | 字符串 | 直播流的类型。由于我们获取的是正在进行的直播，其值为 live；若出现错误，则值为空字符串。 |
| title | 字符串 | 直播标题。 |
| viewer_count | 整数 | 当前正在观看该直播的观众人数。 |
| started_at | 字符串 | 直播开始的 UTC 时间戳。 |
| language | 字符串 | 直播语言的 ISO-639-1 代码。 |
| thumbnail_url | 字符串 | 直播缩略图的 URL。可通过替换 {width} 和 {height} 占位符为所需的宽度和高度值，来获取不同尺寸的缩略图。 |
| tag_ids | 字符串数组 | 应用于该直播的所有标签的 ID 列表。 |
| is_mature | 布尔值 | 表示该直播是否面向成人观众。 |