Get Playlist

Path Parameters

playlist_id

string

required

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

Query Parameters

string

default:"US"

Content region (ISO 3166-1 alpha-2). Examples: US, GB, DE, JP.

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.

Show PlaylistItem object

position

integer

1-based position in the playlist (nullable).

video_id

string

Video id.

title

string

Video title (nullable).

url

string

Full watch URL (nullable).

length_seconds

integer

Duration in seconds (nullable).

duration

string

Human-readable duration (nullable).

channel_id

string

Uploader channel id (nullable).

channel_name

string

Uploader channel name (nullable).

channel_url

string

Uploader channel URL (nullable).

thumbnails

array

Thumbnail variants with url, width, height.

thumbnail

string

Best thumbnail URL (nullable).

view_count

integer

View count (nullable).

view_count_text

string

View count as displayed (nullable).

published_time_text

string

Relative publish time (nullable).

is_playable

boolean

Whether the item is currently playable (nullable).

set_video_id

string

Per-playlist-entry id (nullable).

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.

Overview

Search & Discovery

Videos & Shorts

Channels

Playlists & Community

Path Parameters

Query Parameters

Response

Example Response

​Path Parameters

​Query Parameters

​Response

​Example Response

Path Parameters

Query Parameters

Response

Example Response