Skip to content

Structured YouTube data: send urls. Single lookup, 1 credit per successful call.

GET · POST1 credit / successful callSingle lookup
GEThttps://api.scrapier.io/api/v2/youtube-channel-info/Open in Playground

Call GET /api/v2/youtube-channel-info/ with urls. The results are in data.items. 1 optional parameter refines the call (see Parameters).

Terminal window
curl -G "https://api.scrapier.io/api/v2/youtube-channel-info/" \
-H "X-API-Key: YOUR_API_KEY" \
--data-urlencode "urls=MrBeast" \
--max-time 210
NameTypeRequiredDefaultDescription
X-API-Key headerstringyes—Your API key from the dashboard.
urlsstringyese.g. MrBeastYouTube channel URL (/@handle, /channel/UC…, /c/, /user/), @handle, name or UC id. Returns one channel record (about + first page of videos/shorts/live/posts).
cursorstringno—Pagination cursor returned in the previous response's next_cursor. Pass it back unchanged to fetch the next page. When next_cursor is null, you have reached the last page.
Advanced
NameTypeDefaultDescription
use_proxybooleantrueRoute the request through Scrapier's residential proxy pool. Default: true. Leave as is unless support tells you otherwise.
raw_databooleanfalseWhen true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under raw_responses, in place of the formatted items. When false (default) you get the formatted output. Pagination (cursor / next_cursor) works the same in both modes.
{
"success": true,
"data": {
"urls": "MrBeast",
"page": 1,
"page_size": 25,
"items": [
{
"channelUrl": "https://www.youtube.com/@MrBeast",
"input": "MrBeast",
"scrapedAt": "2026-10-03T04:17:31",
"scraped_at": "2026-10-03T04:17:31.000Z",
"about": {
"channelDescription": "SUBSCRIBE FOR A COOKIE!\nNew MrBeast or MrBeast Gaming video every single Saturday at noon eastern time!",
"channelJoinedDate": "Feb 19, 2012",
"channelDescriptionLinks": [
{
"text": "Follow",
"url": "https://www.instagram.com/mrbeast/"
},
{
"text": "Twitter",
"url": "https://twitter.com/MrBeast"
}
],
"channelLocation": "United States",
"channelUsername": "MrBeast",
"channelAvatarUrl": "https://yt3.googleusercontent.com/nxYrc_1_2f77DoBadyxMTmv7ZpRZapHR5jbuYe7PlPd5cIRJxtNNEYyOC0ZsxaDyJJzXrnJiuDE=s900-c-k-c0x00ffffff-no-rj",
"channelBannerUrl": "https://yt3.googleusercontent.com/mHMO_eEMp0dPvh0ADwXhPXNYb_GnjSVsLI8biqF1CpxT8OPl7izhNQsDPD3JHhd5y5Mg9GrP=w2560-fcrop64=1,00005a57ffffa5a8-k-c0xffffffff-no-nd-rj",
"channelTotalVideos": 1004,
"channelTotalViews": 141443077746,
"numberOfSubscribers": "519M",
"numberOfSubscribersInt": 519000000,
"isChannelVerified": true,
"channelName": "MrBeast",
"channelUrl": "https://www.youtube.com/channel/UCX6OQ3DkcsbYNE6H8uQQuVA",
"channelId": "UCX6OQ3DkcsbYNE6H8uQQuVA",
"inputChannelUrl": "http://www.youtube.com/@MrBeast",
"channelKeywords": "mrbeast6000 beast mrbeast Mr.Beast mr",
"isAgeRestricted": false
},
"videos": [
{
"id": "v9QtM6qnG50",
"title": "I Built A City To Save Kids From Illegal Labor",
"duration": "19:03",
"channelName": "MrBeast",
"channelUsername": "MrBeast",
"channelUrl": "https://www.youtube.com/channel/UCX6OQ3DkcsbYNE6H8uQQuVA",
"date": "13 days ago",
"url": "https://www.youtube.com/watch?v=v9QtM6qnG50",
"viewCount": 87000000,
"viewCountText": "87M views",
"fromYTUrl": "https://www.youtube.com/@MrBeast/videos",
"type": "video",
"thumbnailUrl": "https://i.ytimg.com/vi/v9QtM6qnG50/hq720.jpg",
"input": "https://www.youtube.com/@MrBeast",
"order": 0
}
],
"shorts": [
{
"videoType": "shorts",
"videoId": "CEJXqm2eiJ0",
"title": "What's Inside My Briefcase?",
"videoUrl": "https://www.youtube.com/shorts/CEJXqm2eiJ0",
"viewsText": "33M views",
"viewCount": 33000000,
"thumbnailUrl": "https://i.ytimg.com/vi/CEJXqm2eiJ0/sardefault.jpg",
"accessibilityText": "What's Inside My Briefcase?, 33 million views - play Short",
"channelName": "MrBeast",
"channelId": "UCX6OQ3DkcsbYNE6H8uQQuVA",
"channelUsername": "MrBeast",
"fromYTUrl": "https://www.youtube.com/@MrBeast/shorts",
"input": "https://www.youtube.com/@MrBeast",
"order": 0
}
],
"live": [],
"posts": [
{
"postId": "UgkxHIfkQ3K2my65-kPq4VkRv9KrBRyN7alx",
"type": "image",
"textContent": "NO MORE WAITING, this Saturday ... finally goes live!",
"imageUrls": [
"https://yt3.ggpht.com/-gQueci3cQXl50-Tgiv_Ru65aUfw2-6aHe9ny2Iy1KWoU1iAALkCZ9VeiZkH5tcqqiAjaTjb50D7iQ=s1320-rw-nd-v1"
],
"pollOptions": [],
"likesCount": 230000,
"likesCountText": "230K",
"commentsCount": 4900,
"commentsCountText": "4.9K",
"publishedAt": "4 days ago",
"postUrl": "https://www.youtube.com/post/UgkxHIfkQ3K2my65-kPq4VkRv9KrBRyN7alx",
"channelName": "MrBeast",
"channelUrl": "https://www.youtube.com/@MrBeast",
"order": 0
}
],
"stats": {
"totalVideos": 10,
"totalShorts": 10,
"totalLiveStreams": 0,
"totalPosts": 10,
"scrapingTimeSeconds": 2.72
}
}
],
"next_cursor": null
}
}

Sample from the live catalog; arrays trimmed to 3 items. Results are in data.items.

FieldTypeExampleDescription
urlsstringMrBeast—
pageinteger1—
page_sizeinteger25—
itemsarray[1 item]The results.
next_cursornullnullPass back as cursor for the next page. null on the last page.
items[].channelUrlstringhttps://www.youtube.com/@MrBeast—
items[].inputstringMrBeast—
items[].scrapedAtstring2026-10-03T04:17:31—
items[].scraped_atstring2026-10-03T04:17:31.000Z—
items[].aboutobject{…}—
items[].videosarray[1 item]—
items[].shortsarray[1 item]—
items[].livearray[]—
items[].postsarray[1 item]—
items[].statsobject{…}—

Returns everything in one call; next_cursor is always null.

Failed calls are free. Branch on the HTTP status and read the message from error (or detail). Full details in Errors.

StatusMeaningRetry?Charged?
400Bad or missing input.No — fix the paramsNo
401 / 403Missing, invalid or revoked API key.No — fix the keyNo
402Out of credits (body has balance).No — top upNo
404Unknown endpoint slug.No — check the slugNo
429 / 503Busy or throttled.Yes — after Retry-AfterNo
5xxTarget site or upstream failure, or timeout.Yes — with backoffNo
  • Nothing special: send the inputs, read the result.
  • YouTube Channel Live/Streams — Structured YouTube data: send channels. Cursor-paginated, 1 credit per successful call.
  • YouTube Channel Video Scraper — Structured YouTube data: send youtube_channels. Cursor-paginated, 1 credit per successful call.
  • YouTube Comment Replies — Structured YouTube data: send continuation_tokens. Cursor-paginated, 1 credit per successful call.
  • YouTube Comments — Structured YouTube data: send urls. Cursor-paginated, 1 credit per successful call.