Get playlist

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

GET

https://api.ytapi.dev/v1/playlists/{id}

1 Credit

Returns the playlist's details and its first page of videos (up to 100). For the next page, call the same endpoint with cursor set to the next_cursor you got; repeat until has_more is false. Each page costs 1 credit. Pages after the first carry the videos only, not the playlist details.

Security

API Key

All requests require a valid API key from the developer dashboard.

Headers: Authorization: Bearer YOUR_API_KEYorX-API-Key: YOUR_API_KEY

See Authentication for headers and rate limits.

Path Parameters

Parameter	Type	Required	Description
`id`path	`string`	Yes	Playlist ID (`PL...`) or a full YouTube playlist URL.

Query Parameters

Parameter	Type	Required	Description
`cursor`query	`string`	No	`next_cursor` from the previous page. Leave it out for the first page.

Response (HTTP 200)

{
  "playlist_id": string,          // Canonical playlist ID (PL...)
  "title": string,                // Playlist title
  "video_count": number,          // Total videos in the playlist
  "view_count_text": string,      // Formatted view count (e.g. "25,616 views")
  "author": string,               // Owner channel name
  "thumbnails": [                 // Artwork at one or more sizes
    {
      "url": string,
      "width": number,
      "height": number
    }
  ],
  "videos": [                     // This page of videos
    {
      "video_id": string,         // 11-character video ID
      "title": string,            // Video title
      "index": number,            // Position within the playlist (1-based)
      "length_seconds": number,   // Duration in seconds
      "length_text": string,      // Duration text (e.g. "3:00:00")
      "author": string            // Video creator name
    }
  ],
  "has_more": boolean,            // Whether another page is available
  "next_cursor": string | null    // Opaque cursor for the next page, or null
}

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)
}