Skip to main content
GET
Inspect a playlist

Authorizations

Authorization
string
header
required

Permanent personal API key created in the dashboard. Example: curl -H "Authorization: Bearer aty_…" https://your-host/v1/projects

Path Parameters

provider
enum<string>
required

External video provider.

Available options:
youtube
Example:

"youtube"

id
string
required

Provider playlist ID.

Minimum string length: 1
Example:

"PL123"

Response

Normalized playlist and videos.

type
any
required
id
string
required
title
string
required
thumbnails
object[]
required
isPodcast
boolean
required
url
string<uri>
required
videos
object[]
required
meta
object
required
description
string
channel
object
videoCount
integer
Required range: x >= 0
videoCountText
string
updatedTimeText
string

YouTube’s display text, such as “Updated 4 days ago”.

playUrl
string<uri>

Starts playback from the item represented by the playlist card.

continuation
string
estimatedTotal
integer