Profil

GET/v1/twitch/profile1 kredi

Bir Twitch kanalının profilini döndürür: görünen ad, açıklama, takipçi sayısı, partner durumu, yayında olup olmadığı ve güncel yayın, son yayın, sosyal bağlantılar ile kanalın son 12 videosu ve öne çıkan 12 klibi.

01Sorgu parametreleri

Ad	Tür	Açıklama
handlezorunlu	string	Twitch kullanıcı adı, `@login` ya da kanal URL'si, örneğin `shroud`.
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/profile?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/profile?handle=shroud

{
  "success": true,
  "credits_remaining": 4980,
  "credits_charged": 1,
  "id": "37402112",
  "isLive": false,
  "currentViewersCount": null,
  "lastBroadcast": {
    "startedAt": "2026-10-23T03:07:56.600308Z",
    "title": "NEW CONTENT NEW WEEK NEW ME MMO MIKE IS BACK AND"
  },
  "stream": null,
  "handle": "shroud",
  "displayName": "shroud",
  "profileImageURL": "https://static-cdn.jtvnw.net/jtv_user_pictures/c754eebf-745b-4e0a-814a-10bcaecaabbc-profile_image-150x150.png",
  "bannerImageURL": "https://static-cdn.jtvnw.net/jtv_user_pictures/dbee25e8-55b7-4565-87f0-e9d4661dcc66-profile_banner-480.jpeg",
  "description": "I'm back baby",
  "followers": 11292627,
  "discord": "https://discord.gg/shroud",
  "twitter": "https://twitter.com/shroud",
  "youtube": "https://youtube.com/shroud",
  "instagram": "https://instagram.com/shroud",
  "isPartner": true,
  "allVideos": [
    {
      "animatedPreviewURL": "https://d2nvs31859zcd8.cloudfront.net/dd0b5fb0a5e005b4bd0b_shroud_319660778839_1792689255/storyboards/2907766307-strip-0.jpg",
      "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"
      },
      "id": "2907766307",
      "lengthSeconds": 35613,
      "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",
      "self": {
        "isRestricted": false,
        "viewingHistory": null,
        "__typename": "VideoSelfEdge"
      },
      "title": "NEW CONTENT NEW WEEK NEW ME MMO MIKE IS BACK AND",
      "viewCount": 201452,
      "resourceRestriction": null,
      "contentTags": [],
      "__typename": "Video"
    },
    {
      "animatedPreviewURL": "https://d2vi6trrdongqn.cloudfront.net/71720211397064bb10e1_shroud_320854680156_1792608178/storyboards/2906978606-strip-0.jpg",
      "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"
      },
      "id": "2906978606",
      "lengthSeconds": 17928,
      "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",
      "self": {
        "isRestricted": false,
        "viewingHistory": null,
        "__typename": "VideoSelfEdge"
      },
      "title": "NEW HARDMODE CONTENT GRINDING PHILO STONES AND PVE BOARDS",
      "viewCount": 118119,
      "resourceRestriction": null,
      "contentTags": [],
      "__typename": "Video"
    }
  ],
  "featuredClips": [
    {
      "id": "4096460680",
      "slug": "ComfortableKindCrowTBTacoLeft-KpJlRchhfOpSav2W",
      "clipTitle": "Very cool stuff. Very good game.",
      "clipViewCount": 5205,
      "curator": {
        "id": "43008746",
        "login": "hunney",
        "displayName": "hunney",
        "__typename": "User"
      },
      "clipGame": {
        "id": "460630",
        "slug": "tom-clancys-rainbow-six-siege",
        "name": "Rainbow Six Siege",
        "displayName": "Rainbow Six Siege",
        "boxArtURL": "https://static-cdn.jtvnw.net/ttv-boxart/460630-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/9bd823eb-56d0-4fee-b6a9-d8fd77af0cfc/landscape/thumb/thumb-0000000000-1920x1080.jpg",
      "createdAt": "2026-06-06T07:37:08Z",
      "durationSeconds": 44,
      "isFeatured": true,
      "guestStarParticipants": {
        "host": {
          "id": "37402112",
          "login": "shroud",
          "displayName": "shroud",
          "profileImageURL": "https://static-cdn.jtvnw.net/jtv_user_pictures/c754eebf-745b-4e0a-814a-10bcaecaabbc-profile_image-300x300.png",
          "primaryColorHex": "00ADFF",
          "description": "I'm back baby",
          "__typename": "User"
        },
        "guests": [],
        "sessionIdentifier": "3EgJzvQDtA5aso80zHuCAHqcWQZ",
        "__typename": "GuestStarParticipants"
      },
      "__typename": "Clip"
    },
    {
      "id": "300458633",
      "slug": "UgliestCreativeWolfChefFrank-PJRt7Wmz_gVzJhk6",
      "clipTitle": "guys???",
      "clipViewCount": 7147,
      "curator": {
        "id": "110176631",
        "login": "bnans",
        "displayName": "bnans",
        "__typename": "User"
      },
      "clipGame": {
        "id": "407314011",
        "slug": "marathon",
        "name": "Marathon",
        "displayName": "Marathon",
        "boxArtURL": "https://static-cdn.jtvnw.net/ttv-boxart/407314011_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/89706a34-e080-420a-b49f-06136e5cb7cf/landscape/thumb/thumb-0000000000-1920x1080.jpg",
      "createdAt": "2026-03-13T16:56:15Z",
      "durationSeconds": 41,
      "isFeatured": true,
      "guestStarParticipants": {
        "host": {
          "id": "37402112",
          "login": "shroud",
          "displayName": "shroud",
          "profileImageURL": "https://static-cdn.jtvnw.net/jtv_user_pictures/c754eebf-745b-4e0a-814a-10bcaecaabbc-profile_image-300x300.png",
          "primaryColorHex": "00ADFF",
          "description": "I'm back baby",
          "__typename": "User"
        },
        "guests": [],
        "sessionIdentifier": "3AS3cDdkYXHWGbLEwK0D7YCHu90",
        "__typename": "GuestStarParticipants"
      },
      "__typename": "Clip"
    }
  ],
  "similarStreamers": [
    {
      "id": "110176631",
      "displayName": "bnans",
      "login": "bnans",
      "primaryColorHex": "CAA7FF",
      "profileImageURL": "https://static-cdn.jtvnw.net/jtv_user_pictures/b1a12673-3859-4e7d-8038-e3fe12609fff-profile_image-300x300.png",
      "stream": null,
      "__typename": "User"
    },
    {
      "id": "217003761",
      "displayName": "shroudyrowdy",
      "login": "shroudyrowdy",
      "primaryColorHex": null,
      "profileImageURL": "https://static-cdn.jtvnw.net/jtv_user_pictures/841105a3-3470-4aee-8fd6-eda089a1dbd6-profile_image-300x300.jpg",
      "stream": null,
      "__typename": "User"
    }
  ]
}

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

Her sosyal bağlantı, platformun adını taşıyan kendi üst düzey anahtarıdır (örneğin `twitter`, `youtube`, `discord`). Kanal çevrimdışıyken `currentViewersCount` null'dır. `similarStreamers` kanalın otomatik yayın (autohost) listesidir (yoksa boş). Bilinmeyen kanal ücretsiz 404 döner.

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.