CHchartmetric
Album

Album Playlists

Playlists (status=current or past) featuring an album on a given streaming platform. Items pair a playlist object with the corresponding track metadata.

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/album/{id}/{platform}/{status}/playlists

Request

Path parameters

idinteger required

Chartmetric album ID.

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

Streaming platform. One of spotify, applemusic, deezer, or amazon; supported boolean filters vary by platform.

status'current' | 'past' required

Playlist status relative to the album. current returns playlists currently containing a track from the album; past returns playlists that previously contained one.

Query parameters

sincestring date

Start of the added/removed date window in ISO format (e.g. '2025-11-01'). Defaults to 180 days ago.

untilstring date

End of the added/removed date window in ISO format (e.g. '2025-11-15'). 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 items to return per request.

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).

minFollowersinteger

Minimum follower count for returned playlists. Defaults to 0 (no minimum).

showPositionStatsboolean

If true, include track position statistics on each playlist entry.

Response

Success

Changes

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