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:

Flag spotify applemusic deezer amazon
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.

Path Parameters
  • id
    Type: integer
    min:  
    0
    max:  
    2147483647
    required

    Chartmetric album ID.

  • platform
    Type: string enum
    required

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

    values
    • cm
    • spotify
    • itunes
    • applemusic
    • deezer
  • status
    Type: string enum
    required

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

    values
    • current
    • past
Query Parameters
  • since
    Type: string Format: date

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

  • until
    Type: string Format: date

    End of the added/removed date window in ISO format (e.g. '2025-11-15'). Defaults to today.

  • offset
    Type: integer
    min:  
    0

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

  • limit
    Type: integer
    min:  
    1
    max:  
    100

    Maximum number of items to return per request.

  • indie
    Type: boolean

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

  • majorCurator
    Type: boolean

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

  • editorial
    Type: boolean

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

  • newMusicFriday
    Type: boolean

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

  • editorialBrand
    Type: boolean

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

  • personalized
    Type: boolean

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

  • deezerPartner
    Type: boolean

    Filter to only Deezer partner-curated playlists.

  • chart
    Type: boolean

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

  • thisIs
    Type: boolean

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

  • hundredPercent
    Type: boolean

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

  • radio
    Type: boolean

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

  • fullyPersonalized
    Type: boolean

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

  • brand
    Type: boolean

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

  • musicBrand
    Type: boolean

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

  • nonMusicBrand
    Type: boolean

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

  • popularIndie
    Type: boolean

    Filter to only popular indie playlists with significant follower count.

  • audiobook
    Type: boolean

    Filter to only audiobook playlists.

  • personalityArtist
    Type: boolean

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

  • minFollowers
    Type: integer

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

  • showPositionStats
    Type: boolean

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

Responses
  • application/json
Request Example for get/api/album/{id}/{platform}/{status}/playlists
curl https://api.chartmetric.com/api/album/0/cm/current/playlists \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

{
  "obj": [
    {
      "playlist": {
        "playlist_id": "37i9dQZF1DWWMOmoXKqHTD",
        "track_id": 17340502,
        "position": 22,
        "added_at": "2023-07-11",
        "period": 105,
        "id": 1644599,
        "name": "Songs to Sing in the Car",
        "description": "",
        "image_url": "https://i.scdn.co/image/ab67706f00000003ffa215be1a4c64e3cbf59d1e",
        "sys_last_updated": "2023-10-24T00:00:00.000Z",
        "last_updated": "2023-10-21T09:09:20.000Z",
        "personalized": true,
        "code2": "US",
        "owner_name": "Spotify",
        "owner_id": 2,
        "editorial": false,
        "tags": [
          {
            "id": 462882,
            "name": "Pop"
          },
          {
            "id": 462884,
            "name": "Rock"
          },
          {
            "id": 462889,
            "name": "R&B/Soul"
          }
        ],
        "followers": 10707440,
        "num_track": 100,
        "fdiff_week": 11408,
        "fdiff_month": 36241,
        "catalog": "catalogue ",
        "active_ratio": 0
      },
      "track": {
        "id": 17340502,
        "name": "Watermelon Sugar",
        "isrc": "USSM11912587",
        "spotify_album_id": "7xV2TzoaVc0ycW7fwBwAml",
        "image_url": "https://api.deezer.com/album/119400582/image",
        "spotify_popularity": 89,
        "cm_track": 27222889,
        "spotify_artist_names": [
          "Harry Styles"
        ],
        "track_genre": "dance pop,pop,post-teen pop",
        "cm_artist": [
          558681
        ],
        "artist_names": [
          "Harry Styles"
        ],
        "code2s": [
          "GB"
        ],
        "artist_images": [
          "https://i.scdn.co/image/ab67616100005174f7db7c8ede90a019c54590bb"
        ],
        "artist_covers": [
          null
        ],
        "spotify_artist_ids": [
          "6KImCVD70vtIoJWnq6nGn3"
        ],
        "spotify_track_ids": [
          "6UelLqGlWMcVH1E5c4H7lY"
        ],
        "spotify_album_ids": [
          "7xV2TzoaVc0ycW7fwBwAml"
        ],
        "spotify_duration_ms": 174000,
        "album_ids": [
          5370467
        ],
        "album_names": [
          "Watermelon Sugar"
        ],
        "album_upc": [
          "886448132844"
        ],
        "album_label": [
          "Columbia"
        ],
        "release_dates": [
          "2019-12-13"
        ]
      }
    }
  ]
}

Success