Channel

GET/v1/youtube/channel1 credit

Returns a YouTube channel's public details: name, handle, description, subscriber, video and view counts, join date, country, links, keywords, avatar and banner.

01Query parameters

Name	Type	Description
handleoptional	string	Channel handle, with or without `@` (e.g. `MrBeast`). One of `handle`, `channelId` or `url` is required; if several are given, `handle` wins, then `channelId`.
channelIdoptional	string	Channel id starting with `UC`. One of `handle`, `channelId` or `url` is required.
urloptional	string	Channel URL (e.g. `https://www.youtube.com/@MrBeast`). One of `handle`, `channelId` or `url` is required.
cache_max_ageoptional	string	Accepted for compatibility; every call is fetched fresh, so the value does not change the answer.Accepted values:`1d3d7d14d30d`

02Request

curl "https://api.scrapesocial.ai/v1/youtube/channel?handle=MrBeast" \
  -H "x-api-key: $SCRAPESOCIAL_KEY"

03Responses

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

GET /v1/youtube/channel?handle=MrBeast

{
  "success": true,
  "credits_remaining": 4980,
  "credits_charged": 1,
  "channelId": "UCX6OQ3DkcsbYNE6H8uQQuVA",
  "channel": "http://www.youtube.com/@MrBeast",
  "handle": "@MrBeast",
  "isVerified": true,
  "name": "MrBeast",
  "description": "SUBSCRIBE FOR A COOKIE!\nNew MrBeast or MrBeast Gaming video every single Saturday at noon eastern time!\nAccomplishments:\n- Raised $20,000,000 To Plant 20,000,000 Trees\n- Removed 30,000,000 pounds of trash from the ocean\n- Helped 2,000 people walk again\n- Helped 1,000 blind people see\n- Helped 1,000 deaf people hear\n- Built wells in Africa\n- Built and gave away 100 houses\n- Adopted every dog in a s…",
  "subscriberCount": 523000000,
  "subscriberCountText": "523M subscribers",
  "videoCountText": "1,009 videos",
  "videoCount": 1009,
  "viewCountText": "144,516,221,563 views",
  "viewCount": 144516221563,
  "joinedDateText": "Joined Feb 19, 2012",
  "tags": "mrbeast6000, beast, mrbeast, Mr.Beast, mr",
  "email": null,
  "country": "United States",
  "follow": "https://instagram.com/mrbeast",
  "twitter": "https://twitter.com/MrBeast",
  "facebook": "https://facebook.com/mrbeast",
  "links": [
    "https://instagram.com/mrbeast",
    "https://twitter.com/MrBeast"
  ],
  "keywords": [
    "mrbeast6000",
    "beast"
  ],
  "isFamilySafe": true,
  "avatar": {
    "image": {
      "sources": [
        {
          "url": "https://yt3.googleusercontent.com/nxYrc_1_2f77DoBadyxMTmv7ZpRZapHR5jbuYe7PlPd5cIRJxtNNEYyOC0ZsxaDyJJzXrnJiuDE=s68-c-k-c0x00ffffff-no-rj",
          "width": 68,
          "height": 68
        }
      ]
    },
    "avatarImageSize": "AVATAR_SIZE_M"
  },
  "banner": [
    {
      "url": "https://yt3.googleusercontent.com/mHMO_eEMp0dPvh0ADwXhPXNYb_GnjSVsLI8biqF1CpxT8OPl7izhNQsDPD3JHhd5y5Mg9GrP=w1060-fcrop64=1,00005a57ffffa5a8-k-c0xffffffff-no-nd-rj",
      "width": 1060,
      "height": 175
    },
    {
      "url": "https://yt3.googleusercontent.com/mHMO_eEMp0dPvh0ADwXhPXNYb_GnjSVsLI8biqF1CpxT8OPl7izhNQsDPD3JHhd5y5Mg9GrP=w1138-fcrop64=1,00005a57ffffa5a8-k-c0xffffffff-no-nd-rj",
      "width": 1138,
      "height": 188
    }
  ]
}

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

Counts come both as YouTube's display text (e.g. `subscriberCountText`) and as parsed integers, which keep YouTube's rounding. Besides the `links` list, each channel link also appears as its own top-level key named after the link title. `email` is always null. An unknown channel answers 404 with `accountDoesNotExist: true`, free.

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.