Skip to main content

Path Parameters

playlist_id
string
required
The YouTube playlist id (the list= value, e.g. PLrAXtmErZgOeiKm4sgNOknGvNjby9efdf).

Query Parameters

gl
string
default:"US"
Content region (ISO 3166-1 alpha-2). Examples: US, GB, DE, JP.
hl
string
default:"en"
UI / interface language (BCP-47). Examples: en, de, fr, ja.

Response

playlist_id
string
The playlist id.
title
string
Playlist title (nullable).
description
string
Playlist description (nullable).
playlist_url
string
Full playlist URL (nullable).
video_count
integer
Number of videos in the playlist (nullable).
view_count
integer
Total playlist views (nullable).
view_count_text
string
Total views as displayed (nullable).
last_updated_text
string
When the playlist was last updated, as displayed (nullable).
channel_id
string
Owner channel id (nullable).
channel_name
string
Owner channel name (nullable).
channel_url
string
Owner channel URL (nullable).
channel_is_verified
boolean
Whether the owner channel is verified (nullable).
thumbnails
array
Playlist thumbnail variants with url, width, height.
thumbnail
string
Best/primary thumbnail URL (nullable).
privacy_status
string
Privacy status, e.g. PUBLIC, UNLISTED (nullable).
is_mix
boolean
Whether the playlist is an auto-generated mix (nullable).
videos
array
First page of playlist items.
continuation
string
Token to fetch the next page of items (nullable when no more pages).
scraped_at
string
ISO 8601 timestamp when the playlist was scraped.
scraped_utc
number
Unix timestamp when the playlist was scraped.

Example Response

{
  "playlist_id": "PLrAXtmErZgOeiKm4sgNOknGvNjby9efdf",
  "title": "Top Music Videos",
  "description": "A rotating collection of the biggest music videos.",
  "playlist_url": "https://www.youtube.com/playlist?list=PLrAXtmErZgOeiKm4sgNOknGvNjby9efdf",
  "video_count": 50,
  "view_count": 12400000,
  "view_count_text": "12.4M views",
  "channel_id": "UCBR8-60-B28hp2BmDPdntcQ",
  "channel_name": "YouTube",
  "channel_is_verified": true,
  "thumbnail": "https://i.ytimg.com/vi/dQw4w9WgXcQ/hqdefault.jpg",
  "privacy_status": "PUBLIC",
  "is_mix": false,
  "videos": [
    {
      "position": 1,
      "video_id": "dQw4w9WgXcQ",
      "title": "Rick Astley - Never Gonna Give You Up (Official Video)",
      "url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ&list=PLrAXtmErZgOeiKm4sgNOknGvNjby9efdf",
      "length_seconds": 213,
      "duration": "3:33",
      "channel_name": "Rick Astley",
      "view_count": 1600000000,
      "is_playable": true
    }
  ],
  "continuation": "4qmFsgJhEiRWTFBM...",
  "scraped_at": "2026-06-21T12:00:00Z"
}
Paginate the remaining items with /v1/youtube/playlists/{playlist_id}/items using the returned continuation token. Auto-generated mixes are available at GET /v1/youtube/mixes/{mix_id} and return the same Playlist shape with is_mix: true.
A playlist (or mix) request costs 5 credits. Failed requests are not charged.