Get Playlist

Path Parameters

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

string

The playlist id.

string

Playlist title (nullable).

string

Playlist description (nullable).

string

Full playlist URL (nullable).

integer

Number of videos in the playlist (nullable).

integer

Total playlist views (nullable).

string

Total views as displayed (nullable).

string

When the playlist was last updated, as displayed (nullable).

string

Owner channel id (nullable).

string

Owner channel name (nullable).

string

Owner channel URL (nullable).

boolean

Whether the owner channel is verified (nullable).

array

Playlist thumbnail variants with url, width, height.

string

Best/primary thumbnail URL (nullable).

string

Privacy status, e.g. PUBLIC, UNLISTED (nullable).

boolean

Whether the playlist is an auto-generated mix (nullable).

array

First page of playlist items.

Show PlaylistItem object

integer

1-based position in the playlist (nullable).

string

Video id.

string

Video title (nullable).

string

Full watch URL (nullable).

integer

Duration in seconds (nullable).

string

Human-readable duration (nullable).

string

Uploader channel id (nullable).

string

Uploader channel name (nullable).

string

Uploader channel URL (nullable).

array

Thumbnail variants with url, width, height.

string

Best thumbnail URL (nullable).

integer

View count (nullable).

string

View count as displayed (nullable).

string

Relative publish time (nullable).

boolean

Whether the item is currently playable (nullable).

string

Per-playlist-entry id (nullable).

string

Token to fetch the next page of items (nullable when no more pages).

string

ISO 8601 timestamp when the playlist was scraped.

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