← API Store
Social
YouTube
YouTube
YouTube channel playlists
GET /youtube/v1/channel/playlistsEvery response includes credits_used: the credits this call cost.
Each call costs 1 credits; failed calls are free. Run it in the console playground to see a live result.
Parameters
| Name | Type | Description |
|---|---|---|
channelrequired | string | Example: @NASA |
cursor | string | Value of `next_cursor` from the previous page. |
Every endpoint also takes: raw、fields、fresh、output、records
{
"cached": false,
"count": 30,
"credits_used": 1,
"next_cursor": "4qmFsgJgEhhVQ0xBX0RpUjFGZktOdmp1VXBCSG15bFEaRDhnWXJHaW1hQVNZS0pEWmlOVFprWlRjekxUQXdNREF0TWpOaE5pMDVZekptTFRFMFl6RTBaV1kwTUdFMk1BJTNEJTNE",
"playlists": [
{
"badges": [
"3 videos"
],
"channel": null,
"channel_avatar": null,
"channel_id": "UCLA_DiR1FfKNvjuUpBHmylQ",
"channel_name": null,
"channel_url": "https://www.youtube.com/@NASA",
"content_type": "playlist",
"duration_seconds": null,
"id": "PLF98rxtslw6s",
"live": false,
"metadata_parts": [
"Playlist",
"View full playlist"
],
"published": null,
"published_text": null,
"thumbnail": "https://i.ytimg.com/vi/9wq3VHsL_bE/hqdefault.jpg?sqp=-oaymwEXCOADEI4CSFryq4qpAwkIARUAAIhCGAE=&rs=AOn4CLCC7609JJdE1ic8h5PLtaCFmDRDYg",
"thumbnails": [
{
"height": 270,
"url": "https://i.ytimg.com/vi/9wq3VHsL_bE/hqdefault.jpg?sqp=-oaymwEXCOADEI4CSFryq4qpAwkIARUAAIhCGAE=&rs=AOn4CLCC7609JJdE1ic8h5PLtaCFmDRDYg",
"width": 480
}
],
"title": "Nancy Grace Roman Space Telescope",
"type": "playlist",
"upcoming": false,
"url": "https://www.youtube.com/playlist?list=PLF98rxtslw6s",
"video_count": 3,
"view_count": null,
"views": "View full playlist"
},
{
"badges": [
"9 videos"
],
"channel": null,
"channel_avatar": null,
"channel_id": "UCLA_DiR1FfKNvjuUpBHmylQ",
"channel_name": null,
"channel_url": "https://www.youtube.com/@NASA",
"content_type": "playlist",
"duration_seconds": null,
"id": "PLB29CbKaE2OY",
"live": false,
"metadata_parts": [
"Playlist",
"View full playlist"
],
"published": null,
"published_text": null,
"thumbnail": "https://i.ytimg.com/pl_c/PLB29CbKaE2OY/studio_square_thumbnail.jpg?sqp=CNep7tYG-oaymwEICIAKENAFSFqi85f_AwYIqMLO0wY=&rs=AOn4CLDYOU4RlyZkvPgr5…",
"thumbnails": [
{
"height": 240,
"url": "https://i.ytimg.com/pl_c/PLB29CbKaE2OY/studio_square_thumbnail.jpg?sqp=CNep7tYG-oaymwEICKoDEPABSFqi85f_AwYIqMLO0wY=&rs=AOn4CLCSedBJqK-8C18L3…",
"width": 426
},
{
"height": 480,
"url": "https://i.ytimg.com/pl_c/PLB29CbKaE2OY/studio_square_thumbnail.jpg?sqp=CNep7tYG-oaymwEICNYGEOADSFqi85f_AwYIqMLO0wY=&rs=AOn4CLCT1-FVvujkfypRI…",
"width": 854
},
"… 1 more"
],
"title": "NASA Moon Base",
"type": "playlist",
"upcoming": false,
"url": "https://www.youtube.com/playlist?list=PLB29CbKaE2OY",
"video_count": 9,
"view_count": null,
"views": "View full playlist"
},
"… 28 more"
]
} Response fields (35)
Field paths and types observed in the sample response; the live response is authoritative.
$ | object |
$.cached | boolean |
$.count | integer |
$.credits_used | integer |
$.next_cursor | string |
$.playlists | array |
$.playlists[] | object | string |
$.playlists[].badges | array |
$.playlists[].badges[] | string |
$.playlists[].channel | null |
$.playlists[].channel_avatar | null |
$.playlists[].channel_id | string |
$.playlists[].channel_name | null |
$.playlists[].channel_url | string |
$.playlists[].content_type | string |
$.playlists[].duration_seconds | null |
$.playlists[].id | string |
$.playlists[].live | boolean |
$.playlists[].metadata_parts | array |
$.playlists[].metadata_parts[] | string |
$.playlists[].published | null |
$.playlists[].published_text | null |
$.playlists[].thumbnail | string |
$.playlists[].thumbnails | array |
$.playlists[].thumbnails[] | object | string |
$.playlists[].thumbnails[].height | integer |
$.playlists[].thumbnails[].url | string |
$.playlists[].thumbnails[].width | integer |
$.playlists[].title | string |
$.playlists[].type | string |
$.playlists[].upcoming | boolean |
$.playlists[].url | string |
$.playlists[].video_count | integer |
$.playlists[].view_count | null |
$.playlists[].views | string |