Kullanıcı Videoları

GET/v1/twitch/user/videos1 kredi

Bir kanalın videolarını sayfa başına 100 adet listeler; başlık, süre, izlenme sayısı, oyun, küçük resim, hareketli önizleme ve yayın tarihi döner. Türe göre filtrelenip tarihe ya da izlenmeye göre sıralanabilir.

01Sorgu parametreleri

Ad	Tür	Açıklama
handlezorunlu	string	Twitch kullanıcı adı, `@login` ya da kanal URL'si, örneğin `shroud`.
filter_byisteğe bağlı	string	Yalnızca bu türdeki videolar: `HIGHLIGHT` (öne çıkanlar), `ARCHIVE` (geçmiş yayınlar) ya da `UPLOAD` (yüklemeler). Büyük/küçük harf duyarsızdır. Verilmezse tüm türler döner.Kabul edilen değerler:`HIGHLIGHTARCHIVEUPLOAD`
sort_byisteğe bağlı	string	Yayın zamanına ya da izlenme sayısına göre sıralar. Büyük/küçük harf duyarsızdır.Kabul edilen değerler:`TIMEVIEWS`
cursoristeğe bağlı	string	Bir önceki sayfanın `cursor` değeri; sonraki 100 videoyu almak için olduğu gibi geri gönderilir.

02İstek

curl "https://api.scrapesocial.ai/v1/twitch/user/videos?handle=shroud" \
  -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/user/videos?handle=shroud

{
  "success": true,
  "credits_remaining": 4980,
  "credits_charged": 1,
  "videos": [
    {
      "id": "2907766307",
      "animatedPreviewURL": "https://d2nvs31859zcd8.cloudfront.net/dd0b5fb0a5e005b4bd0b_shroud_319660778839_1792689255/storyboards/2907766307-strip-0.jpg",
      "lengthSeconds": 35613,
      "game": {
        "boxArtURL": "https://static-cdn.jtvnw.net/ttv-boxart/771448419_IGDB-40x56.jpg",
        "id": "771448419",
        "slug": "aion-2",
        "displayName": "AION 2",
        "name": "AION 2",
        "__typename": "Game"
      },
      "broadcastIdentifier": {
        "id": "319660778839",
        "__typename": "BroadcastIdOnly"
      },
      "owner": {
        "displayName": "shroud",
        "id": "37402112",
        "login": "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"
      },
      "previewThumbnailURL": "https://static-cdn.jtvnw.net/cf_vods/d2nvs31859zcd8/dd0b5fb0a5e005b4bd0b_shroud_319660778839_1792689255//thumb/thumb0-320x180.jpg",
      "publishedAt": "2026-10-22T17:14:19Z",
      "title": "NEW CONTENT NEW WEEK NEW ME MMO MIKE IS BACK AND",
      "viewCount": 201452,
      "contentTags": []
    },
    {
      "id": "2906978606",
      "animatedPreviewURL": "https://d2vi6trrdongqn.cloudfront.net/71720211397064bb10e1_shroud_320854680156_1792608178/storyboards/2906978606-strip-0.jpg",
      "lengthSeconds": 17928,
      "game": {
        "boxArtURL": "https://static-cdn.jtvnw.net/ttv-boxart/771448419_IGDB-40x56.jpg",
        "id": "771448419",
        "slug": "aion-2",
        "displayName": "AION 2",
        "name": "AION 2",
        "__typename": "Game"
      },
      "broadcastIdentifier": {
        "id": "320854680156",
        "__typename": "BroadcastIdOnly"
      },
      "owner": {
        "displayName": "shroud",
        "id": "37402112",
        "login": "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"
      },
      "previewThumbnailURL": "https://static-cdn.jtvnw.net/cf_vods/d2vi6trrdongqn/71720211397064bb10e1_shroud_320854680156_1792608178//thumb/thumb0-320x180.jpg",
      "publishedAt": "2026-10-21T18:43:03Z",
      "title": "NEW HARDMODE CONTENT GRINDING PHILO STONES AND PVE BOARDS",
      "viewCount": 118119,
      "contentTags": []
    }
  ],
  "hasNextPage": true,
  "cursor": "2771862411|442273|2026-05-14T16:35:11Z|38098"
}

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

Videolar `videos` içinde, sayfa başına 100 adet gelir. `hasNextPage` true olduğu sürece sonraki sayfa için `cursor` değerini (aynı filtre ve sıralamayla) `cursor` parametresiyle geri gönderin; son sayfada `cursor` null olur. Videosu olmayan bir kanal için 200 ve boş bir liste döner, 0 kredi düşer. Bulunamayan bir kanal ücretsiz bir 404 döndürür; geçersiz bir `filter_by`, `sort_by` ya da cursor ü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.