📺

YouTube Playlist Info

Get metadata for a YouTube playlist including title, description, and video count

GET 1 credit /v1/youtube/playlist

curl "https://youtube.toolkitapi.io/v1/youtube/playlist?id=PLrAXtmErZgOeiKm4sgNOknGvNjby9efdf"

import httpx

resp = httpx.get(
    "https://youtube.toolkitapi.io/v1/youtube/playlist?id=PLrAXtmErZgOeiKm4sgNOknGvNjby9efdf",
)
print(resp.json())

const resp = await fetch("https://youtube.toolkitapi.io/v1/youtube/playlist?id=PLrAXtmErZgOeiKm4sgNOknGvNjby9efdf", {
});
const data = await resp.json();
console.log(data);

# See curl example

Response 200 OK

{
  "id": "PLrAXtmErZgOeiKm4sgNOknGvNjby9efdf",
  "url": "https://www.youtube.com/playlist?list=PLrAXtmErZgOeiKm4sgNOknGvNjby9efdf",
  "title": "Learn Python - Full Course for Beginners",
  "description": "A comprehensive Python tutorial covering basics to advanced topics.",
  "videoCount": 42,
  "viewCount": 8500000,
  "lastUpdated": "2024-11-15T10:30:00Z",
  "channel": {
    "id": "UC8butISFwT-Wl7EV0hUK0BQ",
    "name": "freeCodeCamp.org",
    "url": "https://www.youtube.com/channel/UC8butISFwT-Wl7EV0hUK0BQ"
  }
}

Try It Live

Description

Get metadata for a YouTube playlist including title, description, and video count

How to Use

1

1. Pass a playlist ID or full playlist URL in the `id` query parameter.

2

2. The API returns the playlist's metadata including video count and channel information.

3

3. Use `videoCount` to estimate processing time if you plan to extract transcripts or metadata for all videos.

4

4. Follow up with the playlist videos endpoint to get the actual video IDs.

About This Tool

The YouTube Playlist Info endpoint returns metadata for a YouTube playlist, including its title, description, video count, total views, last update date, and the channel that created it.

Use this to inspect playlists before processing their contents, or to display playlist information in content aggregation interfaces. The metadata helps you assess a playlist's scope and freshness.

The endpoint accepts playlist IDs or full playlist URLs.

Why Use This Tool

Playlist preview — Display playlist metadata before committing to full processing
Content curation — Evaluate playlists for inclusion in course catalogues or learning paths
Freshness monitoring — Track `lastUpdated` to detect when playlists receive new content
Channel attribution — Identify which channel created a playlist for proper crediting
Scope estimation — Use `videoCount` to plan batch processing resources

Frequently Asked Questions

Can I use playlist URLs directly?

Yes. Both playlist IDs (e.g. `PLrAXtmErZgOeiKm4sgNOknGvNjby9efdf`) and full YouTube playlist URLs are accepted. The API extracts the playlist ID automatically.

Does this return the video list?

No. This endpoint returns playlist metadata only. Use the playlist videos endpoint (`/v1/youtube/playlist/videos`) to get the list of video IDs.

What if the playlist is private?

Private playlists are not accessible. Only public and unlisted playlists can be queried.

Start using YouTube Playlist Info now

Get your free API key and make your first request in under a minute.

Get Free API Key View Docs