Search APIs
Loading…
← API Store
Social

YouTube

YouTube

YouTube channel playlists

GET /youtube/v1/channel/playlists
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
channelrequiredstring Example: @NASA
cursorstringValue 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
$.cachedboolean
$.countinteger
$.credits_usedinteger
$.next_cursorstring
$.playlistsarray
$.playlists[]object | string
$.playlists[].badgesarray
$.playlists[].badges[]string
$.playlists[].channelnull
$.playlists[].channel_avatarnull
$.playlists[].channel_idstring
$.playlists[].channel_namenull
$.playlists[].channel_urlstring
$.playlists[].content_typestring
$.playlists[].duration_secondsnull
$.playlists[].idstring
$.playlists[].liveboolean
$.playlists[].metadata_partsarray
$.playlists[].metadata_parts[]string
$.playlists[].publishednull
$.playlists[].published_textnull
$.playlists[].thumbnailstring
$.playlists[].thumbnailsarray
$.playlists[].thumbnails[]object | string
$.playlists[].thumbnails[].heightinteger
$.playlists[].thumbnails[].urlstring
$.playlists[].thumbnails[].widthinteger
$.playlists[].titlestring
$.playlists[].typestring
$.playlists[].upcomingboolean
$.playlists[].urlstring
$.playlists[].video_countinteger
$.playlists[].view_countnull
$.playlists[].viewsstring