CHchartmetric
Playlist

List Playlist Tracks (Current or Past)

List tracks currently on or previously on a playlist, optionally enriched with artist/album/audio-feature details. Use span=current for active tracks, span=past for historical removals.

get/api/playlist/{platform}/{id}/{span}/tracks

Request

Path parameters

string required
OR
integer required
platform'cm' | 'spotify' | 'itunes' | 'applemusic' | 'deezer' | 'shazam' | 'beatport' | 'amazon' | 'youtube' | 'tunefind' | 'soundcloud' required

Streaming platform. One of spotify, itunes, deezer, amazon, youtube, soundcloud.

span'current' | 'past' required

Time span. current returns tracks currently on the playlist; past returns tracks that were on the playlist but have since been removed.

Query parameters

withDetailsboolean

If true, hydrate each track with artist, album, and audio-feature details. Defaults to true.

sincestring date

Only return tracks with removed_at after this date in YYYY-MM-DD format. Applies only to span=past.

untilstring date

Only return tracks with added_at before this date in YYYY-MM-DD format. Applies only to span=past.

storefrontstring

ISO 3166-1 alpha-2 country code (2 letters, e.g. 'US', 'BR', 'GB').

version_only[]string[]

Filter to tracks where ONLY the specified version cluster types are true and all others are false. Cannot be combined with version_and, version_or, or version_not.

version_and[]string[]

Filter to tracks that contain ALL of the specified version cluster types. Cannot be combined with version_or.

version_or[]string[]

Filter to tracks that contain AT LEAST ONE of the specified version cluster types. Cannot be combined with version_and.

version_not[]string[]

Filter to tracks that contain NONE of the specified version cluster types.

limitinteger

Maximum number of items to return per request.

offsetinteger

Number of items to skip from the start of the result set; pair with limit to paginate.

Response

Success

Changes

No recorded changes to this operation across all 1 revision of this API.