YouTube playlist details

Look up metadata for a public YouTube playlist by id.

← All YouTube endpoints · Capability overview

GET/v1/youtube/playlist-details

https://api.vee3.io/v1/youtube/playlist-details

10 tokens

Look up metadata for a public YouTube playlist by id.

Authorization

Send your API key in the Authorization header:

Authorization: Bearer YOUR_API_KEY

MCP

The same capability is available as an MCP tool on Vee3 hosted MCP.

Tool name

get_youtube_playlist_details

Parameters1 field

playlist_idstringRequired

YouTube playlist id (for example PLcirGkCPmbmFeQ1sm4wFciF03D_EroIfr).

max length 512

Response22 fields

playlistIdstring

Canonical YouTube playlist id.

titlestring

Playlist title.

descriptionstring

Playlist description.

updatedTimestring

Last update date (ISO 8601).

updatedTimeTextstring

Human-readable last update time.

badgesarrayitems

1 field

Playlist badges when available.

badgestring

Badge label.

authorobject

7 fields

Playlist creator summary.

titlestring

Playlist creator display name.

channelIdstring

Creator channel id.

canonicalBaseUrlstring

Canonical channel path on YouTube when available.

avatararrayitems

3 fields

Creator avatar images at different sizes.

heightinteger

Image height in pixels.

widthinteger

Image width in pixels.

urlstring

Image URL.

statsobject

2 fields

Public playlist statistics.

videosinteger

Number of videos in the playlist.

viewsinteger

Total playlist view count.

thumbnailsarrayitems

3 fields

Playlist thumbnail images at different sizes.

heightinteger

Image height in pixels.

widthinteger

Image width in pixels.

urlstring

Image URL.

HTTP errors: unauthorized, validation_error, insufficient_tokens, payment_required, youtube_playlist_not_found, youtube_not_configured, youtube_upstream_error

Example request

Python

import requests

url = "https://api.vee3.io/v1/youtube/playlist-details"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
}
params = {
    "playlist_id": "PLcirGkCPmbmFeQ1sm4wFciF03D_EroIfr"
}

response = requests.get(url, headers=headers, params=params)
response.raise_for_status()
data = response.json()
print(data)

Example responses1 example

200Sample playlist details for Today's Hits Clean 2022.

todays_hits_clean_playlist.json

{
  "playlistId": "PLcirGkCPmbmFeQ1sm4wFciF03D_EroIfr",
  "title": "Today's Hits Clean 2022 - Clean Songs Playlist  - Clean Music 2022",
  "description": "Today's Hits Clean 2022 - Clean Songs Playlist  - Clean Music 2022",
  "updatedTime": "2022-06-21",
  "updatedTimeText": "Updated Jun 21, 2022",
  "badges": [],
  "author": {
    "title": "Roses are Red",
    "channelId": "UC6LgzwM4TqzlkX5AuwOe-ag",
    "canonicalBaseUrl": "/channel/UC6LgzwM4TqzlkX5AuwOe-ag",
    "avatar": [
      {
        "height": 48,
        "url": "https://yt3.ggpht.com/example=s48-c-k-c0x00ffffff-no-rj",
        "width": 48
      }
    ]
  },
  "stats": {
    "videos": 100,
    "views": 76877178
  },
  "thumbnails": [
    {
      "height": 94,
      "url": "https://i.ytimg.com/vi/mRD0-GxqHVo/hqdefault.jpg",
      "width": 168
    }
  ]
}