Klip
GET/v1/twitch/clip1 kredi
Bir klibin ayrıntılarını döndürür: başlık, izlenme sayısı, oluşturulma tarihi, süre, klibi alan kişi, oyun, yayıncı, küçük resim, mevcut video kaliteleri ve doğrudan oynatılabilen bir MP4 bağlantısı; ayrıca yayıncının en popüler klipleri.
01Sorgu parametreleri
| Ad | Tür | Açıklama |
|---|---|---|
| urlzorunlu | string | Klibin URL'si: `https://www.twitch.tv/<kanal>/clip/<slug>` ya da `https://clips.twitch.tv/<slug>`. |
| cache_max_ageisteğe bağlı | string | Uyumluluk için kabul edilir: önbellekteki bir yanıtın en fazla ne kadar eski olabileceğini belirtir. Her çağrı canlı olarak çekildiği için yanıtı da fiyatı da değiştirmez.Kabul edilen değerler:1d3d7d14d30d |
02İstek
curl "https://api.scrapesocial.ai/v1/twitch/clip?url=https%3A%2F%2Fwww.twitch.tv%2Fshroud%2Fclip%2FTiredVivaciousFlamingoWTRuck-rwZawI7Z6rN76kzI" \ -H "x-api-key: $SCRAPESOCIAL_KEY"
03Yanıtlar
API'nin gerçek yanıtları. Listeler 2 öğeye kısaltılmıştır.
GET /v1/twitch/clip?url=https%3A%2F%2Fwww.twitch.tv%2Fshroud%2Fclip%2FTiredVivaciousFlamingoWTRuck-rwZawI7Z6rN76kzI
{
"0": {
"data": {
"clip": {
"id": "3835802848",
"slug": "TiredVivaciousFlamingoWTRuck-rwZawI7Z6rN76kzI",
"url": "https://www.twitch.tv/shroud/clip/TiredVivaciousFlamingoWTRuck-rwZawI7Z6rN76kzI",
"embedURL": "https://clips.twitch.tv/embed?clip=TiredVivaciousFlamingoWTRuck-rwZawI7Z6rN76kzI",
"title": "Top 10 Results",
"viewCount": 157664,
"language": "EN",
"isFeatured": true,
"assets": [
{
"id": "6136748f-88f4-4970-8161-10d4fc583f7b/LANDSCAPE",
"aspectRatio": 1.7777777777777777,
"type": "SOURCE",
"createdAt": "2025-11-24T21:10:35.483368333Z",
"creationState": "CREATED",
"curator": {
"id": "43008746",
"login": "hunney",
"displayName": "hunney",
"profileImageURL": "https://static-cdn.jtvnw.net/jtv_user_pictures/hunney-profile_image-0c340ce30907da4e-50x50.jpeg",
"__typename": "User"
},
"thumbnailURL": "https://static-cdn.jtvnw.net/twitch-video-assets/twitch-vap-video-assets-prod-us-west-2/6136748f-88f4-4970-8161-10d4fc583f7b/landscape/thumb/thumb-0000000000-1920x1080.jpg",
"videoQualities": [
{
"frameRate": 0,
"quality": "1080",
"sourceURL": "https://d1ndex63qxojbr.cloudfront.net/nauth/6136748f-88f4-4970-8161-10d4fc583f7b/landscape/avc/1080/index.mp4",
"__typename": "ClipVideoQuality"
},
{
"frameRate": 0,
"quality": "720",
"sourceURL": "https://d1ndex63qxojbr.cloudfront.net/nauth/6136748f-88f4-4970-8161-10d4fc583f7b/landscape/avc/720/index.mp4",
"__typename": "ClipVideoQuality"
}
],
"portraitMetadata": null,
"__typename": "ClipAsset"
},
{
"id": "6136748f-88f4-4970-8161-10d4fc583f7b/PORTRAIT",
"aspectRatio": 0.5625,
"type": "RECOMPOSED",
"createdAt": "2025-11-24T21:10:35.483368333Z",
"creationState": "CREATED",
"curator": {
"id": "43008746",
"login": "hunney",
"displayName": "hunney",
"profileImageURL": "https://static-cdn.jtvnw.net/jtv_user_pictures/hunney-profile_image-0c340ce30907da4e-50x50.jpeg",
"__typename": "User"
},
"thumbnailURL": "https://static-cdn.jtvnw.net/twitch-video-assets/twitch-vap-video-assets-prod-us-west-2/6136748f-88f4-4970-8161-10d4fc583f7b/portrait/thumb/thumb-0000000001-153x272.jpg",
"videoQualities": [
{
"frameRate": 0,
"quality": "606",
"sourceURL": "https://d1ndex63qxojbr.cloudfront.net/nauth/6136748f-88f4-4970-8161-10d4fc583f7b/portrait/avc/606/index.mp4",
"__typename": "ClipVideoQuality"
},
{
"frameRate": 0,
"quality": "480",
"sourceURL": "https://d1ndex63qxojbr.cloudfront.net/nauth/6136748f-88f4-4970-8161-10d4fc583f7b/portrait/avc/480/index.mp4",
"__typename": "ClipVideoQuality"
}
],
"portraitMetadata": null,
"__typename": "ClipAsset"
}
],
"curator": {
"id": "43008746",
"login": "hunney",
"displayName": "hunney",
"profileImageURL": "https://static-cdn.jtvnw.net/jtv_user_pictures/hunney-profile_image-0c340ce30907da4e-70x70.jpeg",
"__typename": "User"
},
"game": {
"id": "464339927",
"name": "ARC Raiders",
"boxArtURL": "https://static-cdn.jtvnw.net/ttv-boxart/464339927-52x72.jpg",
"displayName": "ARC Raiders",
"slug": "arc-raiders",
"__typename": "Game"
},
"broadcast": {
"id": "315988957276",
"title": null,
"__typename": "Broadcast"
},
"broadcaster": {
"id": "37402112",
"login": "shroud",
"displayName": "shroud",
"primaryColorHex": "00ADFF",
"isPartner": true,
"profileImageURL": "https://static-cdn.jtvnw.net/jtv_user_pictures/c754eebf-745b-4e0a-814a-10bcaecaabbc-profile_image-70x70.png",
"followers": {
"totalCount": 11292627,
"__typename": "FollowerConnection"
},
"stream": null,
"lastBroadcast": {
"id": "319660778839",
"startedAt": "2026-10-23T03:07:56.600308Z",
"__typename": "Broadcast"
},
"self": null,
"__typename": "User"
},
"thumbnailURL": "https://static-cdn.jtvnw.net/twitch-video-assets/twitch-vap-video-assets-prod-us-west-2/6136748f-88f4-4970-8161-10d4fc583f7b/landscape/thumb/thumb-0000000000-1920x1080.jpg",
"createdAt": "2025-11-24T21:10:35Z",
"isPublished": true,
"durationSeconds": 4,
"champBadge": null,
"playbackAccessToken": {
"signature": "ca505ea9d276dacb4390fbd16e2e7469e8dcd163",
"value": "{\"authorization\":{\"forbidden\":false,\"reason\":\"\"},\"clip_uri\":\"https://d1ndex63qxojbr.cloudfront.net/nauth/6136748f-88f4-4970-8161-10d4fc583f7b/landscape/avc/1080/index.mp4\",\"clip_slug\":\"TiredVivaciousFlamingoWTRuck-rwZawI7Z6rN76kzI\",\"device_id\":null,\"expires\":1793020097,\"user_id\":\"\",\"version\":3}",
"__typename": "PlaybackAccessToken"
},
"video": {
"id": "2627058232",
"broadcastType": "ARCHIVE",
"title": "DID I MAKE IT TO WILDCARD 3???",
"__typename": "Video"
},
"videoOffsetSeconds": 5368,
"videoQualities": [
{
"sourceURL": "https://d1ndex63qxojbr.cloudfront.net/nauth/6136748f-88f4-4970-8161-10d4fc583f7b/landscape/avc/1080/index.mp4",
"__typename": "ClipVideoQuality"
},
{
"sourceURL": "https://d1ndex63qxojbr.cloudfront.net/nauth/6136748f-88f4-4970-8161-10d4fc583f7b/landscape/avc/720/index.mp4",
"__typename": "ClipVideoQuality"
}
],
"isViewerEditRestricted": true,
"suggestedCropping": null,
"__typename": "Clip",
"videoURL": "https://d1ndex63qxojbr.cloudfront.net/nauth/6136748f-88f4-4970-8161-10d4fc583f7b/landscape/avc/1080/index.mp4?sig=ca505ea9d276dacb4390fbd16e2e7469e8dcd163&token=%7B%22authorization%22%3A%7B%22forbidden%22%3Afalse%2C%22reason%22%3A%22%22%7D%2C%22clip_uri%22%3A%22https%3A%2F%2Fd1ndex63qxojbr.cloudfront.net%2Fnauth%2F6136748f-88f4-4970-8161-10d4fc583f7b%2Flandscape%2Favc%2F1080%2Findex.mp4%22%2C%22cl…"
}
},
"extensions": {
"durationMilliseconds": 106,
"requestID": "01M5T0HMKH94CZW0PZZQEERWHG",
"operationName": "ShareClipRenderStatus"
}
},
"1": {
"data": {
"user": {
"id": "37402112",
"clips": {
"pageInfo": {
"hasNextPage": true,
"__typename": "PageInfo"
},
"edges": [
{
"cursor": null,
"node": {
"id": "2358589597",
"slug": "TangentialBillowingJalapenoYee-ccA2oB1pEYh4CHWJ",
"url": "https://www.twitch.tv/shroud/clip/TangentialBillowingJalapenoYee-ccA2oB1pEYh4CHWJ",
"embedURL": "https://clips.twitch.tv/embed?clip=TangentialBillowingJalapenoYee-ccA2oB1pEYh4CHWJ",
"title": "F Shroud",
"viewCount": 563391,
"language": "EN",
"curator": {
"id": "165804164",
"login": "pato_bolado",
"displayName": "Pato_Bolado",
"__typename": "User"
},
"game": {
"id": "515024",
"slug": "diablo-iv",
"name": "Diablo IV",
"boxArtURL": "https://static-cdn.jtvnw.net/ttv-boxart/515024-52x72.jpg",
"__typename": "Game"
},
"broadcaster": {
"id": "37402112",
"login": "shroud",
"displayName": "shroud",
"profileImageURL": "https://static-cdn.jtvnw.net/jtv_user_pictures/c754eebf-745b-4e0a-814a-10bcaecaabbc-profile_image-50x50.png",
"primaryColorHex": "00ADFF",
"roles": {
"isPartner": true,
"__typename": "UserRoles"
},
"__typename": "User"
},
"thumbnailURL": "https://static-cdn.jtvnw.net/twitch-video-assets/twitch-vap-video-assets-prod-us-west-2/5696a6a8-e053-4c2e-a54c-5ca62c48102e/landscape/thumb/thumb-0000000000-1920x1080.jpg",
"createdAt": "2023-06-02T11:41:50Z",
"durationSeconds": 28,
"champBadge": null,
"isFeatured": false,
"guestStarParticipants": null,
"__typename": "Clip"
},
"__typename": "ClipEdge"
},
{
"cursor": null,
"node": {
"id": "3663533447",
"slug": "SuccessfulEndearingPidgeonPunchTrees-46KXLAMeuS9kpp5Q",
"url": "https://www.twitch.tv/shroud/clip/SuccessfulEndearingPidgeonPunchTrees-46KXLAMeuS9kpp5Q",
"embedURL": "https://clips.twitch.tv/embed?clip=SuccessfulEndearingPidgeonPunchTrees-46KXLAMeuS9kpp5Q",
"title": "it's gonna be over",
"viewCount": 563031,
"language": "EN",
"curator": {
"id": "63640236",
"login": "jawnpeed",
"displayName": "JawnPeed",
"__typename": "User"
},
"game": {
"id": "512923",
"slug": "baldurs-gate-3",
"name": "Baldur's Gate 3",
"boxArtURL": "https://static-cdn.jtvnw.net/ttv-boxart/512923_IGDB-52x72.jpg",
"__typename": "Game"
},
"broadcaster": {
"id": "37402112",
"login": "shroud",
"displayName": "shroud",
"profileImageURL": "https://static-cdn.jtvnw.net/jtv_user_pictures/c754eebf-745b-4e0a-814a-10bcaecaabbc-profile_image-50x50.png",
"primaryColorHex": "00ADFF",
"roles": {
"isPartner": true,
"__typename": "UserRoles"
},
"__typename": "User"
},
"thumbnailURL": "https://static-cdn.jtvnw.net/twitch-video-assets/twitch-vap-video-assets-prod-us-west-2/05f80190-90b4-4569-94ce-36a01d87b191/landscape/thumb/thumb-0000000000-1920x1080.jpg",
"createdAt": "2023-08-05T10:53:38Z",
"durationSeconds": 19,
"champBadge": null,
"isFeatured": false,
"guestStarParticipants": null,
"__typename": "Clip"
},
"__typename": "ClipEdge"
}
],
"__typename": "ClipConnection"
},
"__typename": "User"
}
},
"extensions": {
"durationMilliseconds": 150,
"requestID": "01M5T0HN41WVBR00PRGHBDFZQ5",
"operationName": "ClipsCards__User"
}
},
"2": {
"data": {
"user": {
"id": "37402112",
"login": "shroud",
"displayName": "shroud",
"__typename": "User"
}
},
"extensions": {
"durationMilliseconds": 5,
"requestID": "01M5T0HN41WVBR00PRGHBDFZQ5",
"operationName": "GetDisplayName"
}
},
"success": true,
"credits_remaining": 4980,
"credits_charged": 1
}Tüm uç noktalarda ortak
Her rota bunları döndürebilir: eksik ya da hatalı anahtar, biten kredi, yanıt vermeyen platform ya da bizim tarafımızdaki bir hata. Hiçbiri kredi harcamaz.
GET /v1/cosmos/profile?handle=design
{
"success": false,
"message": "Invalid API key"
}04Notlar
Yanıtta zarfın yanında numaralı üç anahtar bulunur: `"0"` klibi `data.clip` altında taşır (`videoURL` imzalı bir MP4 bağlantısıdır), `"1"` yayıncının tüm zamanların en çok izlenen 20 klibini, `"2"` yayıncının kimliğini, kullanıcı adını ve görünen adını içerir. Bulunamayan bir klip ücretsiz bir 404 döndürür; Twitch klibi olmayan bir URL ücretsiz bir 400 hatası verir.
05Hatalar ve krediler
Her hatada success: false ve gerçek bir HTTP durum kodu döner; kredi düşmez.
400missing_parameter
Zorunlu bir parametre eksik veya geçersiz.
403private_account
Hesap gizli ya da yaş kısıtlamalı.
404not_found
Böyle bir hesap yok.
503upstream_error
Platform şu an cevap vermiyor; tekrar deneyin.