Profile

GET/v1/twitch/profile1 credit

Returns a Twitch channel's profile: display name, description, follower count, partner status, live status and current stream, last broadcast, social links, and the channel's 12 latest videos and 12 featured clips.

01Query parameters

Name	Type	Description
handlerequired	string	The Twitch login, `@login` or a channel URL, e.g. `shroud`.
cache_max_ageoptional	string	Accepted for compatibility: how old a cached answer may be. Every call is fetched fresh, so it does not change the answer or the price.Accepted values:`1d3d7d14d30d`

02Request

curl "https://api.scrapesocial.ai/v1/twitch/profile?handle=shroud" \
  -H "x-api-key: $SCRAPESOCIAL_KEY"

03Responses

Real answers from the API. Lists are shortened to 2 items.

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"
    }
  ]
}

Common to every endpoint

Any route can answer these: a missing or wrong key, no credits left, the platform not answering, or a failure on our side. None of them costs credits.

GET /v1/cosmos/profile?handle=design

{
  "success": false,
  "message": "Invalid API key"
}

04Notes

Each social link is its own top-level key named after the platform (for example `twitter`, `youtube`, `discord`). `currentViewersCount` is null while the channel is offline. `similarStreamers` is the channel's autohost list (empty when it has none). An unknown channel is a free 404.

05Errors & credits

Every error has success: false, a real HTTP status and costs no credits.

400missing_parameter
A required parameter is missing or invalid.
403private_account
The account is private or age-restricted.
404not_found
No such account.
503upstream_error
The platform did not answer; retry shortly.