> Parel documentation. Index of every page: https://parel.si/docs/llms.txt. This page in HTML: https://parel.si/docs/tools/get_youtube_shorts

# 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`](https://parel.si/docs/tools/get_youtube_channel_videos.md) lists the long-form uploads, [`get_youtube`](https://parel.si/docs/tools/get_youtube.md) one video's numbers, [`get_youtube_transcript`](https://parel.si/docs/tools/get_youtube_transcript.md) 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

```bash
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:

```json
{
  "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

- [`get_youtube_channel_videos`](https://parel.si/docs/tools/get_youtube_channel_videos.md)
- [`get_youtube`](https://parel.si/docs/tools/get_youtube.md)
- [`get_youtube_transcript`](https://parel.si/docs/tools/get_youtube_transcript.md)
