Logo
Section 1 / 3

获取视频

学习如何获取关于Twitch视频的信息。

导入

获取视频

学习如何获取关于Twitch视频的信息。

...
视频端点概览

代码示例

1https://api.twitch.tv/helix/videos

参数类型分类说明
id字符串必需视频的ID。提供此参数后，无需其他参数（包括 user_id 和 game_id）。最多可提供100个视频ID。
user_id字符串必需要获取其视频的用户的ID。只能提供一个用户ID。
game_id字符串必需要获取其视频的游戏的ID。只能提供一个游戏ID。
after字符串可选用于向前分页的游标值。该端点返回多页结果时，每页都会包含一个游标值。将此值放入 after 参数中，可获取游标指定页面之后的结果页。仅在使用 user_id 或 game_id 时可用，不能与 id 一起使用。
before字符串可选用于向后分页的游标值。该端点返回多页结果时，每页都会包含一个游标值。将此值放入 before 参数中，可获取游标指定页面之前的结果页。仅在使用 user_id 或 game_id 时可用，不能与 id 一起使用。
first整数可选每页返回的结果数量，最大为100条。默认值为20。
language字符串可选视频语言的 ISO-639-1 两字母代码。
period字符串可选视频创建的时间范围。可接受的值为 "all"、"day"、"week" 和 "month"。默认值为 "all"。
sort字符串可选返回视频的排序方式。可接受的值为 "time"（按时间）、"trending"（按热门度）和 "views"（按观看次数）。默认值为 "time"。
type字符串可选视频类型。视频可以是直播回放、精彩片段等。可接受的值为 "all"、"upload"（上传）、"archive"（归档）和 "highlight"（精华）。默认值为 "all"。
1headers = {
2    'Authorization': 'Bearer {{APP_ACCESS_TOKEN}}',
3    'Client-Id': '{{CLIENT_ID}}'
4}
5
6parameters = {
7    'user_id': '12826',  # 官方Twitch频道
8    'sort': 'views'
9}
10
11response = requests.get('https://api.twitch.tv/helix/videos',
12                        headers=headers, params=parameters).json()
13
14print(json.dumps(response, indent=4))
1headers = {
2    'Authorization': 'Bearer {{APP_ACCESS_TOKEN}}',
3    'Client-Id': '{{CLIENT_ID}}'
4}
5
6parameters = {
7    'id': '{{VIDEO_ID}}'
8}
9
10response = requests.get('https://api.twitch.tv/helix/videos',
11                        headers=headers, params=parameters).json()
12
13print(json.dumps(response, indent=4))

属性类型说明
id字符串视频的ID。
stream_id字符串视频来源的直播流ID（如果有的话）。仅当 type 属性为 "archive" 时才有值，否则为 null。
user_id字符串视频所属用户的ID。
user_login字符串视频所属用户的登录名。
user_name字符串视频所属用户的显示名称。
title字符串视频在用户个人资料上显示的标题。
description字符串视频的描述内容。
created_at字符串视频创建时间的 RFC3339 格式时间戳。
published_at字符串视频发布时间的 RFC3339 格式时间戳。
url字符串视频可访问/查看的URL。
thumbnail_url字符串视频缩略图的静态URL。
viewable字符串视频的可见性设置，取值为 "public"（公开）或 "private"（私密）。
view_count整数视频累计的观看次数。
language字符串视频语言的 ISO-639-1 代码。
type字符串视频类型，表示视频是过往直播的重传、新上传的内容还是精选片段等。可能值包括 "upload"、"archive" 和 "highlight"。
duration字符串视频的播放时长。
muted_segments对象表示视频中被静音的部分（如有）。该对象包含两个字段：duration（静音段时长）和 offset（静音段起始位置距视频开头的时间偏移）。

流

获取剪辑