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.
| 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
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.