/v1/twitch/user/videos

GET

User Videos

Get Twitch user videos

Credit cost	Default: 1 credit How charges are determined Cost is decided per call, not per endpoint: the same operation can cost different amounts depending on what it returns. A call that fails costs 0 credits. A result served from cache costs 0 credits. `default` is the cost when no rule matches. Rules are evaluated in order and the first whose conditions all hold wins. A `when` condition is one of: `param` (the request parameter is true), `outcome` (the classifier's outcome), `empty` / `nonEmpty` (a response field is empty and absent, or a non-empty array or string), `flag` (a response field is exactly true). A cost of `{ perStartedMinute: n, of: [fields] }` is n x max(1, ceil(seconds / 60)), so even a short result bills at least one minute.
Cache support	Not specified in the published contract.
Pagination	No explicit pagination metadata in the published contract. Consult the parameters and response fields below.

Parameters

Name	Location / required	Schema
`handle` Twitch handle	query / required	`string`
`filter_by` Filter by	query / optional	`string` Allowed values `["HIGHLIGHT","ARCHIVE","UPLOAD"]`
`sort_by` Sort by	query / optional	`string` Allowed values `["TIME","VIEWS"]`

Request examples

Replace placeholder values and supply your own API key. For operations with a request body, populate the body using the schema above.

cURL

curl --request GET 'https://api.fetchproof.com/v1/twitch/user/videos?handle=YOUR_HANDLE' \
  --header 'x-api-key: YOUR_API_KEY'

JavaScript

const response = await fetch("https://api.fetchproof.com/v1/twitch/user/videos?handle=YOUR_HANDLE", {
  method: 'GET',
  headers: { 'x-api-key': process.env.FETCHPROOF_API_KEY }
});
console.log(await response.text());

Python

import os
import requests

response = requests.get("https://api.fetchproof.com/v1/twitch/user/videos?handle=YOUR_HANDLE",
    headers={"x-api-key": os.environ["FETCHPROOF_API_KEY"]})
print(response.text)

Responses

200Success. Envelope: success / credits_remaining / credits_charged.

application/json

object

successrequired

boolean

credits_remainingrequired

integer

credits_chargedrequired

integer

idoptional

string

isLiveoptional

boolean

currentViewersCountoptional

integer

streamoptional

object

idrequired

string

createdAtrequired

string

{
  "format": "date-time"
}

gamerequired

object

idrequired

string

displayNamerequired

string

__typenamerequired

string

typerequired

string

viewersCountrequired

integer

__typenamerequired

string

tagsrequired

array

Array items

object

idrequired

string

namerequired

string

__typenamerequired

string

handleoptional

string

displayNameoptional

string

profileImageURLoptional

string

bannerImageURLoptional

string

descriptionoptional

string

followersoptional

integer

xoptional

string

instagramoptional

string

youtubeoptional

string

tiktokoptional

string

isPartneroptional

boolean

allVideosoptional

array

Array items

object

animatedPreviewURLrequired

string

gamerequired

object

boxArtURLrequired

string

idrequired

string

slugrequired

string

displayNamerequired

string

namerequired

string

__typenamerequired

string

idrequired

string

lengthSecondsrequired

integer

ownerrequired

object

displayNamerequired

string

idrequired

string

loginrequired

string

profileImageURLrequired

string

primaryColorHexrequired

null

rolesrequired

object

isPartnerrequired

boolean

__typenamerequired

string

__typenamerequired

string

previewThumbnailURLrequired

string

publishedAtrequired

string

{
  "format": "date-time"
}

selfrequired

object

isRestrictedrequired

boolean

viewingHistoryrequired

null

__typenamerequired

string

titlerequired

string

viewCountrequired

integer

resourceRestrictionrequired

null

contentTagsrequired

array

__typenamerequired

string

featuredClipsoptional

array

Array items

object

idrequired

string

slugrequired

string

clipTitlerequired

string

clipViewCountrequired

integer

curatorrequired

object

idrequired

string

loginrequired

string

displayNamerequired

string

__typenamerequired

string

clipGamerequired

object

idrequired

string

slugrequired

string

namerequired

string

displayNamerequired

string

boxArtURLrequired

string

__typenamerequired

string

broadcasterrequired

object

idrequired

string

loginrequired

string

displayNamerequired

string

profileImageURLrequired

string

primaryColorHexrequired

null

rolesrequired

object

isPartnerrequired

boolean

__typenamerequired

string

__typenamerequired

string

thumbnailURLrequired

string

createdAtrequired

string

{
  "format": "date-time"
}

durationSecondsrequired

integer

isFeaturedrequired

boolean

guestStarParticipantsrequired

object

hostrequired

object

idrequired

string

loginrequired

string

displayNamerequired

string

profileImageURLrequired

string

primaryColorHexrequired

null

descriptionrequired

string

__typenamerequired

string

guestsrequired

array

sessionIdentifierrequired

string

__typenamerequired

string

__typenamerequired

string

similarStreamersoptional

array

Array items

object

idrequired

string

displayNamerequired

string

loginrequired

string

primaryColorHexrequired

string

profileImageURLrequired

string

streamrequired

null

__typenamerequired

string

videosoptional

array

Array items

object

idrequired

string

animatedPreviewURLrequired

string

lengthSecondsrequired

integer

gamerequired

object

boxArtURLrequired

string

idrequired

string

slugrequired

string

displayNamerequired

string

namerequired

string

__typenamerequired

string

broadcastIdentifierrequired

object

idrequired

string

__typenamerequired

string

ownerrequired

object

displayNamerequired

string

idrequired

string

loginrequired

string

profileImageURLrequired

string

primaryColorHexrequired

string

rolesrequired

object

isPartnerrequired

boolean

__typenamerequired

string

__typenamerequired

string

previewThumbnailURLrequired

string

publishedAtrequired

string

{
  "format": "date-time"
}

titlerequired

string

viewCountrequired

integer

contentTagsrequired

array

hasNextPageoptional

boolean

cursoroptional

string

401Invalid or missing x-api-key

402No credits remaining

403Upstream denied (age gate, audience controls)

404Resource or endpoint not found

429Rate limited