CHchartmetric
Track

List Playlists Containing a Track

Return playlists that currently (or previously) contain a track. platform accepts spotify, applemusic (aliased to itunes), deezer, amazon, soundcloud. status is current or past.

Allowed sortColumn per (platform, status):

platformstatusValid sortColumn values
spotifycurrentadded_at, fdiff_month, followers (default), name, position, peak_position, track, code2
spotifypastadded_at, fdiff_month, followers (default), name, position, peak_position, removed_at, track, code2
applemusiccurrentadded_at (default), name, position, peak_position
applemusicpastadded_at, name, position, peak_position, removed_at (default)
deezercurrentadded_at (default), fdiff_month, followers, name, peak_position
deezerpastadded_at, fdiff_month, followers, name, peak_position, removed_at (default)
amazoncurrentadded_at (default), countries, name, peak_position
amazonpastadded_at, peak_position, removed_at (default)
soundcloudcurrentadded_at, fdiff_month, likes, peak_position
soundcloudpastadded_at, fdiff_month, likes, peak_position

Boolean flag parameters supported per platform:

Flagspotifyapplemusicdeezeramazon
editorial✅✅✅
editorialBrand✅
personalized✅
deezerPartner✅
chart✅✅✅
thisIs✅
hundredPercent✅
newMusicFriday✅
radio✅✅
fullyPersonalized✅
brand✅✅
majorCurator✅✅
musicBrand✅
nonMusicBrand✅
popularIndie✅✅
indie✅✅✅
audiobook✅
personalityArtist✅

Amazon does not accept any flags. Flags are not mutually exclusive — pass others as false to scope to one. When no flags are specified the API may return an empty array; specify flags explicitly to get data.

get/api/track/{id}/{platform}/{status}/playlists

Request

Path parameters

idinteger required

Chartmetric track ID.

platform'spotify' | 'applemusic' | 'deezer' | 'amazon' | 'soundcloud' required

Streaming platform. One of spotify, applemusic (aliased to itunes), deezer, amazon, soundcloud.

status'current' | 'past' required

Whether to return playlists the track is currently on or has been removed from (past).

Query parameters

sincestring date

Inclusive start of the added/removed-at date range in YYYY-MM-DD format. Defaults to 180 days before today.

untilstring date

Inclusive end of the added/removed-at date range in YYYY-MM-DD format. Defaults to today.

offsetinteger

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

limitinteger

Maximum number of playlists to return. Max 100.

indieboolean

Filter to only playlists tagged as indie (independently curated).

majorCuratorboolean

Filter to only playlists owned by a major-label curator (Sony, Universal, Warner, etc.).

editorialboolean

Filter to only editorial playlists curated by the platform (e.g. Spotify-owned). Defaults to true; pass false to include user-curated playlists.

newMusicFridayboolean

Filter to only New Music Friday-style new-release playlists.

editorialBrandboolean

Filter to only editorial playlists operated by a brand (e.g. retailer or media outlet).

personalizedboolean

Filter to only personalized playlists (e.g. Discover Weekly, Release Radar). May vary per listener.

deezerPartnerboolean

Filter to only Deezer partner-curated playlists.

chartboolean

Filter to only chart playlists (e.g. Top 50, Viral 50). Reflects platform-published rankings.

thisIsboolean

Filter to only artist-spotlight playlists in the 'This Is X' format.

hundredPercentboolean

Filter to only playlists composed entirely of one artist's catalog.

radioboolean

Filter to only algorithmic radio-style playlists generated from a seed track or artist.

fullyPersonalizedboolean

Filter to only fully personalized playlists where the entire tracklist is unique per listener.

brandboolean

Filter to only brand-operated playlists (any flavor — music, non-music, retailer, media).

musicBrandboolean

Filter to only music-industry brand playlists (labels, music publications).

nonMusicBrandboolean

Filter to only non-music-industry brand playlists (retailers, media outlets, lifestyle).

popularIndieboolean

Filter to only popular indie playlists with significant follower count.

audiobookboolean

Filter to only audiobook playlists.

personalityArtistboolean

Filter to only playlists curated by personality artists (artists with cultural influence beyond their music).

sortColumnstring

Column to sort by; allowed values vary by platform and status (e.g. added_at, followers, peak_position).

sortOrderDescboolean

If true, sort descending by sortColumn. Only valid when sortColumn is set. Defaults to true.

minFollowersinteger

Restrict to playlists with at least this many followers. Defaults to 0 (no filter).

showPositionStatsboolean

If true, include the track's position-history aggregates (peak position, current position) on each entry. Defaults to false.

Response

Success

Changes

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