Skip to content

Structured YouTube data: every input is optional. Cursor-paginated, 1 credit per successful call.

GET · POST1 credit / successful callCursor-paginated
GEThttps://api.scrapier.io/api/v2/youtube-shorts/Open in Playground

Call GET /api/v2/youtube-shorts/. The results are in data.shorts; send data.next_cursor back as cursor to get the next page. 4 optional parameters refine the call (see Parameters).

Terminal window
curl -G "https://api.scrapier.io/api/v2/youtube-shorts/" \
-H "X-API-Key: YOUR_API_KEY" \
--max-time 210
NameTypeRequiredDefaultDescription
X-API-Key headerstringyes—Your API key from the dashboard.
modestringnosinglesingle / video (one Short via input_value) or multi / channel (a channel Shorts tab, 25 per page). When channels is set it always wins.
singlevideomultichannel
input_valuestringnodQw4w9WgXcQShort URL or 11-char video ID (single mode). A channel URL/@handle here is treated as channel mode.
channelsstringno—Channel @handle, URL (/@x, /channel/UC..., /c/x, /user/x, .../shorts) or UC id. Returns its Shorts newest-first, 25 per call; follow next_cursor.
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": {
"channels": "@MrBeast",
"channel_id": "UCX6OQ3DkcsbYNE6H8uQQuVA",
"page": 1,
"page_size": 25,
"shorts": [
{
"title": "What’s Inside My Briefcase?",
"type": "shorts",
"id": "CEJXqm2eiJ0",
"url": "https://www.youtube.com/shorts/CEJXqm2eiJ0",
"thumbnailUrl": "https://i.ytimg.com/vi/CEJXqm2eiJ0/hqdefault.jpg",
"viewCount": 33038101,
"date": "2026-09-27T00:00:00.000Z",
"likes": 625000,
"commentsCount": 14647,
"duration": "00:00:40",
"text": "What’s Inside My Briefcase?",
"hashtags": "",
"descriptionLinks": null,
"channelName": "MrBeast",
"channelUrl": "https://www.youtube.com/@MrBeast",
"channelUsername": "MrBeast",
"channelId": "UCX6OQ3DkcsbYNE6H8uQQuVA",
"channelDescription": "SUBSCRIBE FOR A COOKIE!",
"channelJoinedDate": "Feb 19, 2012",
"channelLocation": "United States",
"channelDescriptionLinks": "https://www.instagram.com/mrbeast",
"channelAvatarUrl": "https://yt3.googleusercontent.com/nxYrc_1_2f77DoBadyxMTmv7ZpRZapHR5jbuYe7PlPd5cIRJxtNNEYyOC0ZsxaDyJJzXrnJiuDE=s160-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": 519000000,
"isChannelVerified": true,
"inputChannelUrl": "https://www.youtube.com/@MrBeast",
"isAgeRestricted": false,
"commentsTurnedOff": false,
"order": 1,
"input": "@MrBeast",
"fromYTUrl": "https://www.youtube.com/@MrBeast/shorts",
"fromChannelListPage": "shorts",
"detailsFetched": true,
"scraped_at": "2026-10-03T04:21:19.275Z"
}
],
"next_cursor": "eyJoZCI6eyJoIjoiTXJCZWFzdCIsIm4iOiJNckJlYXN0In0sImkiOiJATXJCZWFzdCIsImsiOiJjaGFubmVscyIsIm8iOjI1LCJwIjoyLCJ1IjoiVUNYNk9RM0RrY3NiWU5FNkg4dVFRdVZBIiwidiI6Mn0"
}
}

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

FieldTypeExampleDescription
channelsstring@MrBeast—
channel_idstringUCX6OQ3DkcsbYNE6H8uQQuVA—
pageinteger1—
page_sizeinteger25—
shortsarray[1 item]The results.
next_cursorstringeyJoZCI6eyJoIjoiTXJCZWFzdCIsIm4iOiJNckJlYXN0I…Pass back as cursor for the next page. null on the last page.
shorts[].titlestringWhat’s Inside My Briefcase?—
shorts[].typestringshorts—
shorts[].idstringCEJXqm2eiJ0—
shorts[].urlstringhttps://www.youtube.com/shorts/CEJXqm2eiJ0—
shorts[].thumbnailUrlstringhttps://i.ytimg.com/vi/CEJXqm2eiJ0/hqdefault.jpg—
shorts[].viewCountinteger33038101—
shorts[].datestring2026-09-27T00:00:00.000Z—
shorts[].likesinteger625000—
shorts[].commentsCountinteger14647—
shorts[].durationstring00:00:40—
shorts[].textstringWhat’s Inside My Briefcase?—
shorts[].hashtagsstring—
shorts[].descriptionLinksnullnull—
shorts[].channelNamestringMrBeast—
shorts[].channelUrlstringhttps://www.youtube.com/@MrBeast—
shorts[].channelUsernamestringMrBeast—
shorts[].channelIdstringUCX6OQ3DkcsbYNE6H8uQQuVA—
shorts[].channelDescriptionstringSUBSCRIBE FOR A COOKIE!—
shorts[].channelJoinedDatestringFeb 19, 2012—
shorts[].channelLocationstringUnited States—
shorts[].channelDescriptionLinksstringhttps://www.instagram.com/mrbeast—
shorts[].channelAvatarUrlstringhttps://yt3.googleusercontent.com/nxYrc_1_2f7…—
shorts[].channelBannerUrlstringhttps://yt3.googleusercontent.com/mHMO_eEMp0d…—
shorts[].channelTotalVideosinteger1004—
shorts[].channelTotalViewsinteger141443077746—
shorts[].numberOfSubscribersinteger519000000—
shorts[].isChannelVerifiedbooleantrue—
shorts[].inputChannelUrlstringhttps://www.youtube.com/@MrBeast—
shorts[].isAgeRestrictedbooleanfalse—
shorts[].commentsTurnedOffbooleanfalse—
shorts[].orderinteger1—
shorts[].inputstring@MrBeast—
shorts[].fromYTUrlstringhttps://www.youtube.com/@MrBeast/shorts—
shorts[].fromChannelListPagestringshorts—
shorts[].detailsFetchedbooleantrue—
shorts[].scraped_atstring2026-10-03T04:21:19.275Z—

Pass data.next_cursor back as cursor until it is null. Required inputs are ignored once a cursor is sent. Each page is one billed call. More in Pagination.

const url = "https://api.scrapier.io/api/v2/youtube-shorts/";
let params = {};
const items = [];
for (let page = 0; page < 10; page++) { // each page is one billed call
const res = await fetch(`${url}?${new URLSearchParams(params)}`, {
headers: { "X-API-Key": "YOUR_API_KEY" },
signal: AbortSignal.timeout(210_000),
});
const body = await res.json();
if (!res.ok) throw new Error(body.error ?? body.detail ?? `HTTP ${res.status}`);
const data = body.data;
items.push(...(data.shorts ?? []));
if (!data.next_cursor) break; // null = last page
params = { cursor: data.next_cursor };
}

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.