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 lists the uploads, get_youtube_channel 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.

FieldTypeRequiredDescription
handlestringone ofThe channel's handle ("MrBeast"), instead of channelId.
channelIdstringone ofThe UC… channel id.
continuationTokenstringnoThe 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 whenit fails, or the provider answers but there is nothing in it (an empty list, no email, no page): class: "ok_free", ₹0
Timeout30 s, then upstream_timeout (₹0, retryable)
Over MCPrun_tool with tool: "get_youtube_playlists"
Over RESTPOST https://api.parel.si/v1/run with "tool": "get_youtube_playlists"
Confirmationnot 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_playlists","input":{"handle":"TechnicalGuruji"}}'

What comes back

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

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

This page as Markdown: /docs/tools/get_youtube_playlists.md. Something wrong or missing: hello@parel.si.