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

# get_youtube_playlists

> A channel's playlists: title, video count, link and thumbnail. ₹0.28 per page; a result that finds nothing is ₹0.

## What it does

The playlists of one YouTube channel from its handle or channelId: data with each playlist's id, title, video count, thumbnail and link, plus a continuationToken for the next page.

Use it to see how a channel organises its content (a brand's tutorials, a creator's series); [`get_youtube_channel_videos`](https://parel.si/docs/tools/get_youtube_channel_videos.md) lists the uploads, [`get_youtube_channel`](https://parel.si/docs/tools/get_youtube_channel.md) the channel's totals. Flat price per page; a channel with no playlists is free. One to four seconds.

India: any public channel.

## Inputs

Generated from the contract captured from staging on 2026-11-05.

| Field | Type | Required | Description |
|---|---|---|---|
| `handle` | string | one of | The channel's handle ("MrBeast"), instead of channelId. |
| `channelId` | string | one of | The UC… channel id. |
| `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): `channelId`; `handle`.

## 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 30 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 | 30 s, then `upstream_timeout` (₹0, retryable) |
| Over MCP | `run_tool` with `tool: "get_youtube_playlists"` |
| Over REST | `POST https://api.parel.si/v1/run` with `"tool": "get_youtube_playlists"` |
| 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_playlists","input":{"handle":"TechnicalGuruji"}}'
```

## What comes back

`data`, as the live check of 2026-11-05 recorded it, trimmed:

```json
{
  "playlists": [
    {
      "type": "playlist",
      "id": "PL6MnV_G6g94il8STSD3_NDxK5vGwiD3mN",
      "title": "Cheapest Vs Costliest",
      "thumbnail": "(picture link removed)",
      "playlistUrl": "https://www.youtube.com/playlist?list=PL6MnV_G6g94il8STSD3_NDxK5vGwiD3mN",
      "videoId": "5mvmEf-m09A",
      "videoUrl": "https://www.youtube.com/watch?v=5mvmEf-m09A",
      "videoCount": 4,
      "channel": {
        "id": "UCOhHO2ICt0ti9KAh-QHvttQ",
        "title": "Technical Guruji",
        "handle": "a_user_17",
        "channelUrl": "https://www.youtube.com/@a public figure"
      }
    },
    {
      "type": "playlist",
      "id": "PL6MnV_G6g94gMjuvXROJMPJuQg6RpCkew",
      "title": "WTF",
      "thumbnail": "(picture link removed)",
      "playlistUrl": "https://www.youtube.com/playlist?list=PL6MnV_G6g94gMjuvXROJMPJuQg6RpCkew",
      "videoId": "2g_uVQjjwFk",
      "videoUrl": "https://www.youtube.com/watch?v=2g_uVQjjwFk",
      "videoCount": 218,
      "channel": {
        "id": "UCOhHO2ICt0ti9KAh-QHvttQ",
        "title": "Technical Guruji",
        "handle": "a_user_17",
        "channelUrl": "https://www.youtube.com/@a public figure"
      }
    },
    {
      "type": "playlist",
      "id": "PL6MnV_G6g94i2E2cTW4ZJQbEMEMzs1Den",
      "title": "Shorts",
      "thumbnail": "(picture link removed)",
      "playlistUrl": "https://www.youtube.com/playlist?list=PL6MnV_G6g94i2E2cTW4ZJQbEMEMzs1Den",
      "videoId": "GrZ4_UTjZjE",
      "videoUrl": "https://www.youtube.com/watch?v=GrZ4_UTjZjE",
      "videoCount": 61,
      "channel": {
        "id": "UCOhHO2ICt0ti9KAh-QHvttQ",
        "title": "Technical Guruji",
        "handle": "a_user_17",
        "channelUrl": "https://www.youtube.com/@a public figure"
      }
    }
  ],
  "continuationToken": null
}
```

## Notes

- Flat per page; pass continuationToken for the next page.
- Handle or UC id; a channel with no playlists is free.
- Pairs with get_youtube_channel_videos for the uploads.

## Siblings

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