Twitch

Twitch User Videos API

A channel's VODs, highlights and uploads: title, view count, duration, publish date, thumbnail and the video URL. Sortable by time or views and paginated. Costs 1 credit per request.

POST/api/v1/twitch/user/videos

Authorizations

Authorizationstringheaderrequired

Bearer authentication header of the form Bearer <token>, where <token> is your Scavio API key (e.g. Bearer sk_live_your_key).

Body

application/json

handlestringrequired

Twitch username, @handle, or a twitch.tv/<user> URL.

Example: shroud

typeenum<string>default:ARCHIVE

ARCHIVE (past broadcasts, the default), HIGHLIGHT, UPLOAD or PAST_PREMIERE.

sort_byenum<string>default:TIME

TIME (newest first, the default) or VIEWS.

firstintegerdefault:30

Videos per page, 1-100. Prefer raising this over paginating: deep pagination is gated upstream, a larger page is not.

cursorstring

Pagination cursor from a previous response's cursor field. Twitch integrity-gates video pagination past the first page for anonymous clients, so this can fail where a larger first would have worked.

Request

from scavio import ScavioClient

client = ScavioClient(api_key="sk_live_your_key")
result = client.twitch.user_videos("shroud", first=50)
print(result)

Response

"handle": "xqc",

"total_count": 44,

"cursor": "2818593928|716197|2026-07-12T22:32:16Z|32243"

"response_time": 414

}