Search APIs
Loading…
← API Store
Social

YouTube

YouTube

YouTube playlist

GET /youtube/v1/playlist
Test this endpoint

Every 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

NameTypeDescription
urlrequiredstring Example: https://www.youtube.com/playlist?list=PLBsP89CPrMeMV1oP42Zn2DrWpnFoSaufA
cursorstringValue 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
$.cachedboolean
$.countinteger
$.credits_usedinteger
$.descriptionstring
$.idstring
$.next_cursornull
$.ownerstring
$.titlestring
$.updatednull
$.video_countstring
$.videosarray
$.videos[]object | string
$.videos[].badgesarray
$.videos[].badges[]string
$.videos[].channelstring
$.videos[].channel_avatarstring
$.videos[].channel_idstring
$.videos[].channel_namestring
$.videos[].channel_urlstring
$.videos[].content_typestring
$.videos[].durationstring
$.videos[].duration_secondsinteger
$.videos[].idstring
$.videos[].liveboolean
$.videos[].metadata_partsarray
$.videos[].metadata_parts[]string
$.videos[].publishedstring
$.videos[].published_textstring
$.videos[].thumbnailstring
$.videos[].thumbnailsarray
$.videos[].thumbnails[]object | string
$.videos[].thumbnails[].heightinteger
$.videos[].thumbnails[].urlstring
$.videos[].thumbnails[].widthinteger
$.videos[].titlestring
$.videos[].typestring
$.videos[].upcomingboolean
$.videos[].urlstring
$.videos[].view_countinteger | null
$.videos[].viewsnull | string
$.viewsstring