← API Store
Social
YouTube
YouTube
YouTube playlist
GET /youtube/v1/playlistEvery 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 |
|---|---|---|
urlrequired | string | Example: https://www.youtube.com/playlist?list=PLBsP89CPrMeMV1oP42Zn2DrWpnFoSaufA |
cursor | string | Value of `next_cursor` from the previous page. |
Every endpoint also takes: raw、fields、fresh、output、records
{
"cached": false,
"count": 6,
"credits_used": 1,
"description": "In Retro Tech, Marques Brownlee uncovers the origin and nostalgia of iconic tech..",
"id": "PLBsP89CPrMeMV1oP42Zn2DrWpnFoSaufA",
"next_cursor": null,
"owner": "Marques Brownlee",
"title": "Retro Tech",
"updated": null,
"video_count": "6 videos",
"videos": [
{
"badges": [
"22:55"
],
"channel": "Marques Brownlee",
"channel_avatar": "https://yt3.ggpht.com/qu4TmIaYUlS41-dJ9gZ7DUR3nilvmB5_11i6OKSdvNnBNiyOusZP1bMN6ICnuxtjFBb6ioKgRQ=s68-c-k-c0x00ffffff-no-rj",
"channel_id": "UCBJycsmduvYEL83R_U4JriQ",
"channel_name": "Marques Brownlee",
"channel_url": "https://www.youtube.com/@mkbhd",
"content_type": "video",
"duration": "22:55",
"duration_seconds": 1375,
"id": "kMtN9KJHn5Y",
"live": false,
"metadata_parts": [
"Marques Brownlee",
"9.3M views",
"… 1 more"
],
"published": "6 years ago",
"published_text": "6 years ago",
"thumbnail": "https://i.ytimg.com/vi/kMtN9KJHn5Y/hqdefault.jpg?sqp=-oaymwEcCNACELwBSFXyq4qpAw4IARUAAIhCGAFwAcABBg==&rs=AOn4CLCLmzb7l4iMtJ-_lxz2md1ZOlnWFg",
"thumbnails": [
{
"height": 94,
"url": "https://i.ytimg.com/vi/kMtN9KJHn5Y/hqdefault.jpg?sqp=-oaymwEbCKgBEF5IVfKriqkDDggBFQAAiEIYAXABwAEG&rs=AOn4CLAwTl4v8IoiTf6Zask-JvUrVJRq9g",
"width": 168
},
{
"height": 110,
"url": "https://i.ytimg.com/vi/kMtN9KJHn5Y/hqdefault.jpg?sqp=-oaymwEbCMQBEG5IVfKriqkDDggBFQAAiEIYAXABwAEG&rs=AOn4CLDJGM0lzVN3YkJmCXsj0lBeqSMyTw",
"width": 196
},
"… 2 more"
],
"title": "RETRO TECH: CAMCORDER",
"type": "video",
"upcoming": false,
"url": "https://www.youtube.com/watch?v=kMtN9KJHn5Y",
"view_count": 9300000,
"views": "9.3M views"
},
{
"badges": [
"26:05"
],
"channel": "Marques Brownlee",
"channel_avatar": "https://yt3.ggpht.com/qu4TmIaYUlS41-dJ9gZ7DUR3nilvmB5_11i6OKSdvNnBNiyOusZP1bMN6ICnuxtjFBb6ioKgRQ=s68-c-k-c0x00ffffff-no-rj",
"channel_id": "UCBJycsmduvYEL83R_U4JriQ",
"channel_name": "Marques Brownlee",
"channel_url": "https://www.youtube.com/@mkbhd",
"content_type": "video",
"duration": "26:05",
"duration_seconds": 1565,
"id": "VJI88QIW7H4",
"live": false,
"metadata_parts": [
"Marques Brownlee",
"6 years ago"
],
"published": "6 years ago",
"published_text": "6 years ago",
"thumbnail": "https://i.ytimg.com/vi/VJI88QIW7H4/hqdefault.jpg?sqp=-oaymwEcCNACELwBSFXyq4qpAw4IARUAAIhCGAFwAcABBg==&rs=AOn4CLBX488hvU2R-GEyV7IF96ahFCnHRA",
"thumbnails": [
{
"height": 94,
"url": "https://i.ytimg.com/vi/VJI88QIW7H4/hqdefault.jpg?sqp=-oaymwEbCKgBEF5IVfKriqkDDggBFQAAiEIYAXABwAEG&rs=AOn4CLBEUchVsdlpyJs7HAHb1fI0QJTDoQ",
"width": 168
},
{
"height": 110,
"url": "https://i.ytimg.com/vi/VJI88QIW7H4/hqdefault.jpg?sqp=-oaymwEbCMQBEG5IVfKriqkDDggBFQAAiEIYAXABwAEG&rs=AOn4CLA6RESgzRQptWA7nx0b7C7cCPt1Mw",
"width": 196
},
"… 2 more"
],
"title": "RETRO TECH: MACINTOSH",
"type": "video",
"upcoming": false,
"url": "https://www.youtube.com/watch?v=VJI88QIW7H4",
"view_count": null,
"views": null
},
"… 4 more"
],
"views": "1,129,128 views"
} Response fields (42)
Field paths and types observed in the sample response; the live response is authoritative.
$ | object |
$.cached | boolean |
$.count | integer |
$.credits_used | integer |
$.description | string |
$.id | string |
$.next_cursor | null |
$.owner | string |
$.title | string |
$.updated | null |
$.video_count | string |
$.videos | array |
$.videos[] | object | string |
$.videos[].badges | array |
$.videos[].badges[] | string |
$.videos[].channel | string |
$.videos[].channel_avatar | string |
$.videos[].channel_id | string |
$.videos[].channel_name | string |
$.videos[].channel_url | string |
$.videos[].content_type | string |
$.videos[].duration | string |
$.videos[].duration_seconds | integer |
$.videos[].id | string |
$.videos[].live | boolean |
$.videos[].metadata_parts | array |
$.videos[].metadata_parts[] | string |
$.videos[].published | string |
$.videos[].published_text | string |
$.videos[].thumbnail | string |
$.videos[].thumbnails | array |
$.videos[].thumbnails[] | object | string |
$.videos[].thumbnails[].height | integer |
$.videos[].thumbnails[].url | string |
$.videos[].thumbnails[].width | integer |
$.videos[].title | string |
$.videos[].type | string |
$.videos[].upcoming | boolean |
$.videos[].url | string |
$.videos[].view_count | integer | null |
$.videos[].views | null | string |
$.views | string |