Skip to main content
GET
GetPlaylist

Headers

Authorization
string

OAuth 2.0 Bearer token for user-authenticated requests. Format: Bearer <access_token>. Required for GetUserPlaylists; optional for GetPlaylist if x-api-key is provided.

Example:

"Bearer eyJhbGciOiJSUzI1NiIs..."

x-api-key
string

API key for server-to-server access. Only valid for GetPlaylist on public playlists.

Example:

"ang_live_..."

Accept-Language
string

Preferred locale for localized content in playlist items (BCP 47).

Example:

"ar"

Path Parameters

id
string
required

Unique identifier of the playlist to retrieve.

Query Parameters

page_size
integer<int32>

Maximum number of items to return per page (1-100, default 20).

page_token
string

Opaque page token from a previous response. Omit for the first page.

Response

Successful response

GetPlaylistResponse is the response message containing the playlist and its items.

playlist
object

Playlist represents a user-created or editorial playlist.

items
object[]
nextPageToken
string

Token for the next page of items. Empty if no more pages.