Get playlist

getPlaylist(id, query?, options?): Playlist

GET/v1/playlists/{id}1 Credit

Returns playlist overview plus the initial page of video items. Use next_cursor with List playlist videos for later pages.

Security

API Token

The preferred authorization scheme for the YouTube Transcript API. Create a key with transcripts:read in the developer dashboard.

Example: Authorization: Bearer YOUR_API_KEY

See Authentication for scopes and rate limits.

Accepted permissions (at least one required)

transcripts:read

ParametersExpand Collapse

id:string

Path param:

Playlist ID (PL...) or a full YouTube playlist URL.

required_country?:string

Query param:

ISO country hint used when region availability matters.

ReturnsExpand Collapse

playlist_id:string

Canonical playlist ID.

title:string

Playlist title.

description:string

Playlist description.

video_count:number

Total videos in the playlist.

view_count_text?:string

Display string for views.

author:string

Owner channel name.

thumbnails:Thumbnail[]

Artwork at one or more sizes.

videos:PlaylistVideo[]

First page of items, including video_id, title, index, and duration.

has_more:boolean

Whether another page is available.

next_cursor:string | null

Opaque cursor for the next page.

Get playlist

const id = "PL-_QwjtlyjHZRRt4AQnQtYFxbiVP-oyuF";
const response = await fetch(`https://api.ytapi.dev/v1/playlists/${id}`, {
  headers: {
    Authorization: `Bearer ${process.env.YT_API_KEY}`,
  },
});

const playlist = await response.json();
console.log(playlist.title, playlist.next_cursor);

import os
import requests

playlist_id = "PL-_QwjtlyjHZRRt4AQnQtYFxbiVP-oyuF"
response = requests.get(
    f"https://api.ytapi.dev/v1/playlists/{playlist_id}",
    headers={"Authorization": f"Bearer {os.environ['YT_API_KEY']}"},
)

print(response.json())

curl -X GET "https://api.ytapi.dev/v1/playlists/PL-_QwjtlyjHZRRt4AQnQtYFxbiVP-oyuF" \
  -H "Authorization: Bearer $YT_API_KEY"

package main

import (
	"fmt"
	"net/http"
	"os"
)

func main() {
	url := "https://api.ytapi.dev/v1/playlists/PL-_QwjtlyjHZRRt4AQnQtYFxbiVP-oyuF"
	req, _ := http.NewRequest("GET", url, nil)
	req.Header.Set("Authorization", "Bearer "+os.Getenv("YT_API_KEY"))

	resp, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer resp.Body.Close()
	fmt.Println(resp.Status)
}

200 example

{
  "playlist_id": "PL-_QwjtlyjHZRRt4AQnQtYFxbiVP-oyuF",
  "title": "Pomodoro 25-5 / SWM",
  "description": "Study with me 25-5 pomodoro sessions and lofi beats.",
  "video_count": 94,
  "view_count_text": "25,616 views",
  "author": "Carrot TD",
  "thumbnails": [
    {
      "url": "https://i.ytimg.com/vi/6gMEMYh5HL8/hqdefault.jpg",
      "width": 480,
      "height": 360
    }
  ],
  "videos": [
    {
      "video_id": "6gMEMYh5HL8",
      "title": "3-HOUR STUDY WITH ME / calm lofi / Pomodoro 25-5",
      "index": 1,
      "length_seconds": 10800,
      "length_text": "3:00:00",
      "author": "Carrot TD"
    }
  ],
  "has_more": true,
  "next_cursor": "yt_e48bb6856a23e4e42efc"
}