Skip to the content
Get an API key
  1. API reference
  2. Search and match the catalog

Inspect Playlist Items

POST/public/inspect/playlistItems
CoreAuthBasicTokenDevTokenDocsSession

This endpoint allows you to fetch the tracks of a playlist from a music service without user authentication. You need to provide the playlistId (which can be extracted from a playlist URL) and the serviceId of the music service.

The response includes paginated track results (up to 50 tracks per page). To fetch subsequent pages, pass the nextParam value from the response back in the nextParam field of the request body. When the response nextParam is null, there are no more pages.

Supported services: Spotify, Apple Music, Deezer, YouTube, YouTube Music, SoundCloud, Tidal, Amazon Music, Pandora, Qobuz.

Request body

application/json · required

playlistId
string
requiredID of the playlist on the music service. Can be extracted from the playlist URL.
serviceId
string
requiredID of the music serviceOne of: spotify, youtube, appleMusic, amazonMusic, tidal, resso, boomplay, deezer, pandora, soundCloud, youtubeMusic, napster, qobuz, qqMusic, yandexMusic, vkMusic, zvuk, gaana, jiosaavn, audiomack, audius
nextParam
string
Pagination cursor. Omit to fetch the first page; to fetch a subsequent page pass the nextParam value returned in the previous response.

Response

200application/json · PlaylistItemsResponseok
status
string
requiredOne of: success, not_found, error
source
string
The music service that provided the data
data
object | null
required
data.results
Track[]
required
data.results[].id
string
required
data.results[].entryId
string | null
requiredIdentifier associated with a tracks within a specific collection. It is used to identify a particular instance of a track within a playlist or a user's library. Track entry id can be obtained during fetching playlist items or user's library.
data.results[].name
string
required
data.results[].isrc
string | null
required
data.results[].duration
number | null
required
data.results[].imageUrl
string | null
required
data.results[].previewUrl
string | null
required
data.results[].album
object | null
required
data.results[].album.name
string
required
data.results[].album.id
string | null
required
data.results[].album.totalItems
number | null
required
data.results[].album.artists
ArtistSimplified[] | null
required
data.results[].album.artists.id
string | null
required
data.results[].album.artists.entryId
string | null
requiredIdentifier associated with an artist within a user's library. Artist entry id can be obtained during fetching artists from user's library.
data.results[].album.artists.name
string
required
data.results[].album.artists.imageUrl
string | null
required
data.results[].album.artists.followers
number | null
required
data.results[].artists
ArtistSimplified[] | null
required
data.results[].artists.id
string | null
required
data.results[].artists.entryId
string | null
requiredIdentifier associated with an artist within a user's library. Artist entry id can be obtained during fetching artists from user's library.
data.results[].artists.name
string
required
data.results[].artists.imageUrl
string | null
required
data.results[].artists.followers
number | null
required
data.results[].isAvailable
boolean | null
Indicates whether the track is currently available for playback on the music service. For Spotify: false for local files or greyed-out tracks (copyright lost), true for playable tracks, null when unknown.
data.results[].dateAdded
string | null
data.nextParam
string | null
required
data.totalItems
number | null
required
Example answer
{
  "status": "success",
  "source": "spotify",
  "data": {
    "results": [
      null
    ],
    "nextParam": "eyJvZmZzZXQiOjEwfQ==",
    "totalItems": 25
  }
}