YouTube Channel Playlists API
Playlists a channel has made public. Pass an id from here to /v1/youtube/playlist for the videos in it. Calls cost 1 credit each. A cache hit is free, and a failed or empty response is never charged.
Try it
Prefilled with the request that produced the example below. No key yet? Get a free key.
Request
GET
/v1/youtube/channel/playlists| Parameter | Type | Required | Description |
|---|---|---|---|
| handle | string | yes | Handle (@mrbeast), channel id (UC…), or full URL |
| cursor | string | no | pagination.cursor from a previous response |
Also accepts cache_max_age (a hit costs 0 credits) and include_raw (returns the untouched upstream payload under raw).
curl
curl "$API/v1/youtube/channel/playlists?handle=%40NASA&cache_max_age=7d" \
-H "x-api-key: $KEY"JavaScript
const query = new URLSearchParams({
handle: '@NASA',
cache_max_age: '7d',
});
const response = await fetch(`${API}/v1/youtube/channel/playlists?${query}`, {
headers: { 'x-api-key': KEY },
});
const body = await response.json();
if (!body.success) throw new Error(body.error.code);
// 1 credit, 0 on a cache hit
console.log(body.data, body.meta.creditsCharged);Python
import os, httpx
r = httpx.get(
f"{os.environ['API']}/v1/youtube/channel/playlists",
params={
"handle": "@NASA",
"cache_max_age": "7d",
},
headers={"x-api-key": os.environ["KEY"]},
timeout=30,
)
body = r.json()
if not body["success"]:
raise RuntimeError(body["error"]["code"])
print(body["data"], body["meta"]["creditsCharged"])Example response
Captured on , with raw removed and lists cut to two items. A live call returns current data.
response
{
"success": true,
"data": {
"items": [
{
"platform": "youtube",
"id": "PLF98rxtslw6s",
"url": "https://www.youtube.com/playlist?list=PLF98rxtslw6s",
"title": "Nancy Grace Roman Space Telescope",
"description": null,
"thumbnailUrl": "https://i.ytimg.com/vi/9wq3VHsL_bE/hqdefault.jpg?sqp=-oaymwEXCOADEI4CSFryq4qpAwkIARUAAIhCGAE=&rs=AOn4CLCC7609JJdE1ic8h5PLtaCFmDRDYg",
"videoCount": 3,
"ownerId": "UCLA_DiR1FfKNvjuUpBHmylQ",
"ownerName": "NASA",
"updatedText": null,
"fetchedAt": "2026-10-21T02:00:39.005Z"
},
{
"platform": "youtube",
"id": "PLB29CbKaE2OY",
"url": "https://www.youtube.com/playlist?list=PLB29CbKaE2OY",
"title": "NASA Moon Base",
"description": null,
"thumbnailUrl": "https://i.ytimg.com/pl_c/PLB29CbKaE2OY/studio_square_thumbnail.jpg?sqp=CLfp39YG-oaymwEICIAKENAFSFqi85f_AwYIqMLO0wY=&rs=AOn4CLDx0xFDq_zKRiiOIxy4-mEIig6zbQ",
"videoCount": 9,
"ownerId": "UCLA_DiR1FfKNvjuUpBHmylQ",
"ownerName": "NASA",
"updatedText": null,
"fetchedAt": "2026-10-21T02:00:39.005Z"
}
]
},
"pagination": {
"cursor": "eyJ0IjoiNHFtRnNnSjRFaGhWUTB4QlgwUnBVakZHWmt0T2RtcDFWWEJDU0cxNWJGRWFLa1ZuYkhkaVIwWTFZa2RzZW1SSVRWbEJlVUZDVFVGRk5FRmxiMFJDTUU1dVZHdFNVbUZzUlNVelJKb0NMMkp5YjNkelpTMW1aV1ZrVlVOTVFWOUVhVkl4Um1aTFRuWnFkVlZ3UWtodGVXeFJjR3hoZVd4cGMzUnpNVEEwIiwidiI6IkNnczFWazV1TmxsaWEwZ3pkeWpHdWVEV0JqSUtDZ0pFUlJJRUVnQWdUbUt6QWdxd0FrTjFSVUpEUVZWVGEzZEZRamhSV25WYWNXMUtZbWg0ZFRkVllWOTFiRkpqV0ZsV05HRldhMGR3YlhkS1VGQlRiRVZ1TXkxM05ITkljRmxEYVV4SVdWSktVRVpzUXpFMU9YVXpaVEpwYzBneVVVYzBOM2xJV25oVk5UVm5WMWRaUlZOME9EWkRRbEZ6VEdOdFYwNDBjRXgxVkhoRE9VazVibTFvZG5acVVsUjJlakIyWVdkTVRrOTRlVUl3TTA0dE9XTjBhSGhtVW5GYVZFeEpTSGxhWDBwak5VRTBiVmc0ZUhSbFVta3hOVlJ0ZFZsclNrRTJWbEJ1VTBzNFYwbzRaSEZVVEdkeFNGWm9Sa1ZKVFRWa1kyOUNWRXBHUVdRMmNHNVZMV2d4WTFad1VuTndUbVJuWmxCU2JuRldkR2hUVHpKTlNDMU5jRVIzZVhBNUxWOTJYek5HZEZnNU9WWmFOR1ZZY21aNExWbGZUR1poWlZCb09ESXpSMnhIYzJ4NmRGWjBWbEJoWjBaa09FeENVbGs0WTBNJTNEIiwiYyI6eyJhdXRob3JJZCI6IlVDTEFfRGlSMUZmS052anVVcEJIbXlsUSIsImF1dGhvckhhbmRsZSI6Ik5BU0EiLCJhdXRob3JOYW1lIjoiTkFTQSJ9fQ",
"hasMore": true,
"count": 30
},
"meta": {
"platform": "youtube",
"endpoint": "youtube.channelPlaylists",
"creditsCharged": 1,
"cached": false,
"cacheAgeSeconds": null,
"durationMs": 197,
"requestId": "req_8zov6hc760jtt9akvs8e"
}
}Returns
Returns a list of object in data.items.
Fields
| Field | Type | Present |
|---|---|---|
| platform | "youtube" | always |
| id | string | always |
| url | string | always |
| title | string | null | always |
| description | string | null | always |
| thumbnailUrl | string | null | always |
| videoCount | number | null | always |
| ownerId | string | null | always |
| ownerName | string | null | always |
| updatedText | string | null | always |
| fetchedAt | string | always |
Cost and behaviour
| Credits | 1 per live request, 0 on a cache hit |
| Cacheable | yes: cache_max_age accepts a cached copy |
| Batchable | yes: usable as a target in POST /v1/jobs/batch |
| Subscribable | yes: as often as every 3600 seconds, firing a webhook only on a change |
Other YouTube endpoints
- /v1/youtube/channel Channel details
- /v1/youtube/channel-videos Channel videos
- /v1/youtube/channel/community-posts Channel community posts
- /v1/youtube/channel/lives Channel live streams
- /v1/youtube/channel/shorts Channel shorts
- /v1/youtube/community-post Community post details
- /v1/youtube/playlist Playlist contents
- /v1/youtube/search Search videos