Channel Videos

GET/v1/youtube/channel-videos1 credit

Returns the videos on a channel's Videos tab, newest or most popular first, each with its description, like and comment counts, publish date, genre and duration.

01Query parameters

Name	Type	Description
handleoptional	string	Channel handle, with or without the leading `@` (e.g. `MrBeast`). One of `handle` or `channelId` is required.
channelIdoptional	string	Channel id starting with `UC` (e.g. `UCX6OQ3DkcsbYNE6H8uQQuVA`). One of `handle` or `channelId` is required.
sortoptional	string	Sort order.Default: `latest`Accepted values:`latestpopular`
continuationTokenoptional	string	The `continuationToken` from the previous page. Send it together with the same `handle` or `channelId`.
regionoptional	string	Two-letter country code that sets the YouTube region for the request (e.g. `US`, `GB`).Default: `US`

02Request

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

03Responses

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

GET /v1/youtube/channel-videos?handle=MrBeast

{
  "success": true,
  "credits_remaining": 4980,
  "credits_charged": 1,
  "videos": [
    {
      "type": "video",
      "id": "RE3_PGwDwhw",
      "url": "https://www.youtube.com/watch?v=RE3_PGwDwhw",
      "title": "Lose 150 Lbs Together, Win $250,000",
      "thumbnail": "https://i.ytimg.com/vi/RE3_PGwDwhw/hq720_custom_1.jpg?sqp=CLzt-NYG-oaymwEgCNAFEJQDSFXyq4qpAxIIARUAAIhCGAFwAcABBrgC9xg=&rs=AOn4CLDeg1e4-2M-cVjZzuPXJSH1v_HrSQ",
      "channel": {
        "id": "UCX6OQ3DkcsbYNE6H8uQQuVA",
        "title": "MrBeast",
        "handle": "MrBeast",
        "thumbnail": "https://yt3.googleusercontent.com/nxYrc_1_2f77DoBadyxMTmv7ZpRZapHR5jbuYe7PlPd5cIRJxtNNEYyOC0ZsxaDyJJzXrnJiuDE=s160-c-k-c0x00ffffff-no-rj"
      },
      "viewCountText": "148,555,689",
      "viewCountInt": 148555689,
      "publishedTimeText": "8 days ago",
      "publishedTime": "2026-10-17T17:06:59.478Z",
      "lengthText": "43:17",
      "lengthSeconds": 2597,
      "badges": [],
      "description": "Will this couple be able to lose 150 LBS together by the end?\n\nFunction Health. The most comprehensive health check. 160+ lab tests. Advanced imaging. 5x more labs than your annual physical. $1 a day / $365 a year. Check your health like Tre and Sara. Follow @function on Instagram for more. http://functionhealth.com/mrbeast ‪@functionhealth‬ FunctionPartner\n\nSign up for Step and get $5 from MrBeas…",
      "commentCountText": "70K",
      "commentCountInt": 70000,
      "likeCountInt": 1985183,
      "likeCountText": "1985183",
      "publishDate": "2026-10-17T09:00:18-07:00",
      "genre": "Entertainment",
      "durationMs": 2596000,
      "durationFormatted": "00:43:16"
    },
    {
      "type": "video",
      "id": "plN7JMbadRg",
      "url": "https://www.youtube.com/watch?v=plN7JMbadRg",
      "title": "Eat Everything In A Grocery Store, Win $1,000,000",
      "thumbnail": "https://i.ytimg.com/vi/plN7JMbadRg/hq720_custom_1.jpg?sqp=CLzt-NYG-oaymwEgCNAFEJQDSFXyq4qpAxIIARUAAIhCGAFwAcABBrgC9xg=&rs=AOn4CLDoNepDBUvhPCicZ7D-SZu0q95tsw",
      "channel": {
        "id": "UCX6OQ3DkcsbYNE6H8uQQuVA",
        "title": "MrBeast",
        "handle": "MrBeast",
        "thumbnail": "https://yt3.googleusercontent.com/nxYrc_1_2f77DoBadyxMTmv7ZpRZapHR5jbuYe7PlPd5cIRJxtNNEYyOC0ZsxaDyJJzXrnJiuDE=s160-c-k-c0x00ffffff-no-rj"
      },
      "viewCountText": "299,049,213",
      "viewCountInt": 299049213,
      "publishedTimeText": "3 weeks ago",
      "publishedTime": "2026-10-04T17:06:59.478Z",
      "lengthText": "57:59",
      "lengthSeconds": 3479,
      "badges": [],
      "description": "I trapped 4 strangers in an entire supermarket and the only way out is eating everything inside\n\nThe guys wore Fitbit Air to track their health and fitness throughout their entire time in the store. See what they achieved during the Google Health Awards. GooglePartner\nGoogle Store: https://www.jdoqocy.com/click-1009880...\nAmazon: https://www.amazon.com/Fitbit-Google-...\nAmazon CA: https://www.amaz…",
      "commentCountText": "159K",
      "commentCountInt": 159000,
      "likeCountInt": 4353721,
      "likeCountText": "4353721",
      "publishDate": "2026-10-03T09:00:01-07:00",
      "genre": "Entertainment",
      "durationMs": 3479000,
      "durationFormatted": "00:57:59"
    }
  ],
  "channels": [],
  "playlists": [],
  "shorts": [],
  "shelves": [],
  "lives": [],
  "continuationToken": "4qmFsgLdCBIYVUNYNk9RM0RrY3NiWU5FNkg4dVFRdVZBGsAIOGdhbkJocWtCbnFoQmpxZUJnb2tObUZtTmpjeU9UY3RNREF3TUMweU5UVmlMV0UxWXprdE5UZ3lOREk1WTJJeE9EZ3dFdk1GUVdaelYydHNORkUzV1c5Sk9GRkhiVUpxY0ZOV1NsOWxTV0U1V0RReU0wdFBTVFZHU2sxTGRqSktaRUpWWTJ0c09VdGZlVlZrY0c5dWEyOVpSVnBYVm1OaFJGb3hNbUZvYVdOV1MxbGtYMUJRYW5KYVQzSmlSMDVFU1hkTFlXVkJTamxSTXpKdlRURk5PR295VTJOU1lWaHJjSFZLZFhwM1NHNUJWbUpSTUVoR2IxOXVhVjlpV2tSMlJIb3pWV3RE…"
}

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

30 videos per page, in `videos`. The answer always has six lists (`videos`, `channels`, `playlists`, `shorts`, `shelves`, `lives`) plus `continuationToken`; lists that do not apply are empty. Pass `continuationToken` back with the same `handle` or `channelId` for the next page (a token alone is a 400); it is null on the last page. Each item's `channel` object is filled only on the first page of the `latest` sort. An unknown channel answers 404; a channel that has nothing on this tab returns the empty lists for 0 credits. A token YouTube refuses is a 400.

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.