TWITCH API
User Videos
Retrieve user videos from Twitch with a single API request.
GET
/api/data/v1/twitch/user/videos1credit base cost
Request parameters
Up to 1 creditTwitch handle
Filter by
Sort by
Live requests use your prepaid balance. Cached responses cost zero where supported.
curl --request GET \
--url 'https://fetchgoblin.com/api/data/v1/twitch/user/videos?handle=ishowspeed' \
--header 'x-api-key: YOUR_FETCHGOBLIN_API_KEY'Response
Example{
"success": true,
"id": "51496027",
"isLive": true,
"currentViewersCount": 2740,
"stream": {
"id": "319166855259",
"createdAt": "2026-05-01T16:44:37Z",
"game": {
"id": "21779",
"displayName": "League of Legends",
"__typename": "Game"
},
"type": "live",
"viewersCount": 2740,
"__typename": "Stream",
"tags": [
{
"id": "fft:CHANNEL:51496027:0",
"name": "English",
"__typename": "FreeformTag"
}
]
},
"handle": "loltyler1",
"displayName": "loltyler1",
"profileImageURL": "https://static-cdn.jtvnw.net/jtv_user_pictures/f3591dbe4ee3d94b-profile_image-150x150.png",
"bannerImageURL": "https://static-cdn.jtvnw.net/jtv_user_pictures/303b0767-0fb4-4a9f-b8a1-2d8b99f24630-profile_banner-480.png",
"description": "Season 6 Challenger | Most REFORMED Player NA | #1 Draven World ",
"followers": 5469372,
"x": "https://x.com/loltyler1?mx=2",
"instagram": "https://www.instagram.com/tyler1_alpha/#",
"youtube": "https://www.youtube.com/channel/UCwV_0HmQkRrTcrReaMxPeDw",
"tiktok": "https://www.tiktok.com/@loltyler1",
"isPartner": true,
"allVideos": [
{
"animatedPreviewURL": "https://d1m7jfoe9zdc1j.cloudfront.net/f2ca91ee909630bdb3df_loltyler1_319166855259_1777653877/storyboards/2761630321-strip-0.jpg",
"game": {
"boxArtURL": "https://static-cdn.jtvnw.net/ttv-boxart/21779-40x56.jpg",
"id": "21779",
"slug": "league-of-legends",
"displayName": "League of Legends",
"name": "League of Legends",
"__typename": "Game"
},
"id": "2761630321",
"lengthSeconds": 931,
"owner": {
"displayName": "loltyler1",
"id": "51496027",
"login": "loltyler1",
"profileImageURL": "https://static-cdn.jtvnw.net/jtv_user_pictures/f3591dbe4ee3d94b-profile_image-50x50.png",
"primaryColorHex": null,
"roles": {
"isPartner": true,
"__typename": "UserRoles"
},
"__typename": "User"
},
"previewThumbnailURL": "https://vod-secure.twitch.tv/_404/404_processing_320x180.png",
"publishedAt": "2026-05-01T16:44:42Z",
"self": {
"isRestricted": false,
"viewingHistory": null,
"__typename": "VideoSelfEdge"
},
"title": "TRY MIGHT ! give NEVER ! BACKS NOT DOWN !! held high for MOMENT WAIT !!! tick ticks ticks ... CLOCK BY PATIENT THIN WAITER !! tick ... NOW !",
"viewCount": 0,
"resourceRestriction": null,
"contentTags": [],
"__typename": "Video"
}
],
"featuredClips": [
{
"id": "2907296184",
"slug": "CogentSpeedyWallabyDxCat-nm23_xWWFTxoPI0C",
"clipTitle": "ewc",
"clipViewCount": 19427,
"curator": {
"id": "24179021",
"login": "testrox",
"displayName": "Testrox",
"__typename": "User"
},
"clipGame": {
"id": "55453844",
"slug": "street-fighter-6",
"name": "Street Fighter 6",
"displayName": "Street Fighter 6",
"boxArtURL": "https://static-cdn.jtvnw.net/ttv-boxart/55453844_IGDB-52x72.jpg",
"__typename": "Game"
},
"broadcaster": {
"id": "51496027",
"login": "loltyler1",
"displayName": "loltyler1",
"profileImageURL": "https://static-cdn.jtvnw.net/jtv_user_pictures/f3591dbe4ee3d94b-profile_image-50x50.png",
"primaryColorHex": null,
"roles": {
"isPartner": true,
"__typename": "UserRoles"
},
"__typename": "User"
},
"thumbnailURL": "https://static-cdn.jtvnw.net/twitch-video-assets/twitch-vap-video-assets-prod-us-west-2/53f846ec-21aa-49e4-92e0-3e93b61726f7/landscape/thumb/thumb-0000000000-1920x1080.jpg",
"createdAt": "2025-07-05T08:09:03Z",
"durationSeconds": 25,
"isFeatured": true,
"guestStarParticipants": {
"host": {
"id": "51496027",
"login": "loltyler1",
"displayName": "loltyler1",
"profileImageURL": "https://static-cdn.jtvnw.net/jtv_user_pictures/f3591dbe4ee3d94b-profile_image-300x300.png",
"primaryColorHex": null,
"description": "Season 6 Challenger | Most REFORMED Player NA | #1 Draven World ",
"__typename": "User"
},
"guests": [],
"sessionIdentifier": "2xmd2itvLAiTeLZsWCYYpifxYv1",
"__typename": "GuestStarParticipants"
},
"__typename": "Clip"
}
],
"similarStreamers": [
{
"id": "459567713",
"displayName": "SpectateTyler1",
"login": "spectatetyler1",
"primaryColorHex": "1F69FF",
"profileImageURL": "https://static-cdn.jtvnw.net/jtv_user_pictures/184aa4fd-1fd7-42ab-8170-5b98bd2fb37f-profile_image-300x300.png",
"stream": null,
"__typename": "User"
}
],
"credits_charged": 1,
"credits_remaining": 1000,
"request_id": "00000000-0000-4000-8000-000000000000"
}Illustrative response with example values adapted for FetchGoblin. Run a request to retrieve current platform data.
Response shape
This schema describes the documented data shape. Some platform fields may be absent or null. The response also includes your FetchGoblin request ID and current credit balance.
View JSON Schema +
{
"type": "object",
"properties": {
"success": {
"type": "boolean"
},
"id": {
"type": "string"
},
"isLive": {
"type": "boolean"
},
"currentViewersCount": {
"type": "integer"
},
"stream": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"createdAt": {
"type": "string"
},
"game": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"displayName": {
"type": "string"
},
"__typename": {
"type": "string"
}
}
},
"type": {
"type": "string"
},
"viewersCount": {
"type": "integer"
},
"__typename": {
"type": "string"
},
"tags": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
},
"__typename": {
"type": "string"
}
}
}
}
}
},
"handle": {
"type": "string"
},
"displayName": {
"type": "string"
},
"profileImageURL": {
"type": "string"
},
"bannerImageURL": {
"type": "string"
},
"description": {
"type": "string"
},
"followers": {
"type": "integer"
},
"x": {
"type": "string"
},
"instagram": {
"type": "string"
},
"youtube": {
"type": "string"
},
"tiktok": {
"type": "string"
},
"isPartner": {
"type": "boolean"
},
"allVideos": {
"type": "array",
"items": {
"type": "object",
"properties": {
"animatedPreviewURL": {
"type": "string"
},
"game": {
"type": "object",
"properties": {
"boxArtURL": {
"type": "string"
},
"id": {
"type": "string"
},
"slug": {
"type": "string"
},
"displayName": {
"type": "string"
},
"name": {
"type": "string"
},
"__typename": {
"type": "string"
}
}
},
"id": {
"type": "string"
},
"lengthSeconds": {
"type": "integer"
},
"owner": {
"type": "object",
"properties": {
"displayName": {
"type": "string"
},
"id": {
"type": "string"
},
"login": {
"type": "string"
},
"profileImageURL": {
"type": "string"
},
"primaryColorHex": {
"type": [
"string",
"object",
"array",
"number",
"boolean",
"null"
]
},
"roles": {
"type": "object",
"properties": {
"isPartner": {
"type": "boolean"
},
"__typename": {
"type": "string"
}
}
},
"__typename": {
"type": "string"
}
}
},
"previewThumbnailURL": {
"type": "string"
},
"publishedAt": {
"type": "string"
},
"self": {
"type": "object",
"properties": {
"isRestricted": {
"type": "boolean"
},
"viewingHistory": {
"type": [
"string",
"object",
"array",
"number",
"boolean",
"null"
]
},
"__typename": {
"type": "string"
}
}
},
"title": {
"type": "string"
},
"viewCount": {
"type": "integer"
},
"resourceRestriction": {
"type": [
"string",
"object",
"array",
"number",
"boolean",
"null"
]
},
"contentTags": {
"type": "array"
},
"__typename": {
"type": "string"
}
}
}
},
"featuredClips": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"slug": {
"type": "string"
},
"clipTitle": {
"type": "string"
},
"clipViewCount": {
"type": "integer"
},
"curator": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"login": {
"type": "string"
},
"displayName": {
"type": "string"
},
"__typename": {
"type": "string"
}
}
},
"clipGame": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"slug": {
"type": "string"
},
"name": {
"type": "string"
},
"displayName": {
"type": "string"
},
"boxArtURL": {
"type": "string"
},
"__typename": {
"type": "string"
}
}
},
"broadcaster": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"login": {
"type": "string"
},
"displayName": {
"type": "string"
},
"profileImageURL": {
"type": "string"
},
"primaryColorHex": {
"type": [
"string",
"object",
"array",
"number",
"boolean",
"null"
]
},
"roles": {
"type": "object",
"properties": {
"isPartner": {
"type": "boolean"
},
"__typename": {
"type": "string"
}
}
},
"__typename": {
"type": "string"
}
}
},
"thumbnailURL": {
"type": "string"
},
"createdAt": {
"type": "string"
},
"durationSeconds": {
"type": "integer"
},
"isFeatured": {
"type": "boolean"
},
"guestStarParticipants": {
"type": "object",
"properties": {
"host": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"login": {
"type": "string"
},
"displayName": {
"type": "string"
},
"profileImageURL": {
"type": "string"
},
"primaryColorHex": {
"type": [
"string",
"object",
"array",
"number",
"boolean",
"null"
]
},
"description": {
"type": "string"
},
"__typename": {
"type": "string"
}
}
},
"guests": {
"type": "array"
},
"sessionIdentifier": {
"type": "string"
},
"__typename": {
"type": "string"
}
}
},
"__typename": {
"type": "string"
}
}
}
},
"similarStreamers": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"displayName": {
"type": "string"
},
"login": {
"type": "string"
},
"primaryColorHex": {
"type": "string"
},
"profileImageURL": {
"type": "string"
},
"stream": {
"type": [
"string",
"object",
"array",
"number",
"boolean",
"null"
]
},
"__typename": {
"type": "string"
}
}
}
},
"credits_charged": {
"type": "integer",
"minimum": 0,
"description": "FetchGoblin credits charged for this request."
},
"credits_remaining": {
"type": "integer",
"description": "Your FetchGoblin credit balance after this request."
},
"request_id": {
"type": "string",
"format": "uuid",
"description": "FetchGoblin request identifier."
}
}
}