get_youtube_shorts
A YouTube channel's Shorts: title, link, views, likes, comments and date, newest or most popular first. ₹0.28 per page; a result that finds nothing is ₹0.
What it does
The Shorts of one YouTube channel from its handle or channelId: data with each short's title, url, views, likes, comment count and date, newest first or popular first (sort), with a continuationToken for the next page.
Use it to see which short-form videos a brand or creator publishes and which ones took off; get_youtube_channel_videos lists the long-form uploads, get_youtube one video's numbers, get_youtube_transcript what a video says. Flat price per page; a channel with no Shorts, or an unknown handle, answers nothing, which is free. Two to five seconds.
India: Indian creators publish heavily in Shorts; any public channel works.
Inputs
Generated from the contract captured from staging on 2026-11-05.
| Field | Type | Required | Description |
|---|---|---|---|
sort | string | no | newest (default) or popular. |
handle | string | one of | The channel's @handle ("starterstory"). |
channelId | string | one of | The UC… channel id, instead of handle. |
continuationToken | string | no | The token from the previous answer, for the next page. |
One of these sets must be complete (anything else is invalid_input, ₹0): handle; channelId.
What drives the cost
Flat per page; pass continuationToken for the next page. A result that finds nothing is class: "ok_free", ₹0. The timeout is 39 seconds.
Price today
| Price today | ₹0.28 per page (cost_paise: 28) at ₹93.93 per US dollar on 17 November 2026 |
| Hold before the call | ₹0.42 (hold_paise: 42); when the call settles the real price is charged and the unused part is released |
| ₹0 when | it fails, or the provider answers but there is nothing in it (an empty list, no email, no page): class: "ok_free", ₹0 |
| Timeout | 39 s, then upstream_timeout (₹0, retryable) |
| Over MCP | run_tool with tool: "get_youtube_shorts" |
| Over REST | POST https://api.parel.si/v1/run with "tool": "get_youtube_shorts" |
| Confirmation | not needed (the estimate is under the ₹200 threshold) |
Request
curl https://api.parel.si/v1/run \
-H "Authorization: Bearer $PAREL_KEY" \
-H "Content-Type: application/json" \
-d '{"tool":"get_youtube_shorts","input":{"sort":"popular","handle":"starterstory"}}'
What comes back
data, as the live check of 2026-11-05 recorded it, trimmed:
{
"shorts": [
{
"id": "wUx3M5eP20k",
"url": "https://www.youtube.com/watch?v=wUx3M5eP20k",
"title": "He Started $1M Business Out Of A Van",
"viewCountInt": 2200919,
"likeCountInt": 128432,
"commentCountInt": 371,
"description": "He Started $1M Business Out Of A Van\n\nFor more business ideas sent to your inbox every day visit →\nstarterstory.com\n\n#entrepreneur \n#businessideas \n#milliondollarbusiness \n#starterstory",
"thumbnail": "https://img.youtube.com/vi/wUx3M5eP20k/maxresdefault.jpg"
},
{
"id": "NPUV1kGuUns",
"url": "https://www.youtube.com/watch?v=NPUV1kGuUns",
"title": "The $600K/year Side Project",
"viewCountInt": 542508,
"likeCountInt": 28808,
"commentCountInt": 163,
"description": "",
"thumbnail": "https://img.youtube.com/vi/NPUV1kGuUns/maxresdefault.jpg"
},
{
"id": "315fK3RZqwA",
"url": "https://www.youtube.com/watch?v=315fK3RZqwA",
"title": "How Mark Rober Is Building A $100M Business",
"viewCountInt": 474403,
"likeCountInt": 19094,
"commentCountInt": 99,
"description": "Here's how Mark Rober is on pace to make $30 million dollars this year from his subscription box business.\n\n#entrepreneur \n#starterstory \n#businessideas \n#markrober",
"thumbnail": "https://img.youtube.com/vi/315fK3RZqwA/maxresdefault.jpg"
}
],
"continuationToken": "4qmFsgLdDRIYVUNoaHc2RGxLS1RROW1ZU3BUZlhVWXFBGsANOGdhSENocUVDbEtCQ2pMLUNRb2tObUZtTlRKbE4yRXRNREF3TUMweU56RXdMVGhsTURRdE5UZ3lOREk1WWpkbE1tVTBFdE1KUVdOV09GWmtXRGc1VVhkdWFWcENlRVZTZUVzeFNGbzRURzh4WWtSblNqUmxXRnB0Tm5GNGMya3hhamhEWkRNNVlrOURWbmQw…"
}
Notes
- Flat per page; pass continuationToken for the next page.
- sort popular for the channel's best Shorts, newest for the latest.
- A channel with no Shorts, or an unknown handle, is free.
Siblings
This page as Markdown: /docs/tools/get_youtube_shorts.md. Something wrong or missing: hello@parel.si.