Playlists Featuring an Artist's Tracks

​

Current or past playlists on platform (spotify, applemusic, deezer, amazon, youtube, soundcloud) that feature this artist's tracks. status is current or past.

Allowed sortColumn per (platform, status):

platform status Valid sortColumn values
amazon current added_at (default), countries, name, peak_position, track
applemusic current added_at (default), name, peak_position, position, track
applemusic past added_at, name, peak_position, position, removed_at (default), track
deezer current added_at (default), fdiff_month, followers, name, peak_position, track
deezer past added_at, fdiff_month, followers, name, peak_position, removed_at (default), track
spotify current added_at, code2, fdiff_month, followers (default), name, peak_position, position, track
spotify past added_at, code2, fdiff_month, followers (default), name, peak_position, position, removed_at, track
youtube current added_at (default), name, peak_position, track, vdiff_month, views
youtube past added_at, name, peak_position, removed_at (default), track, vdiff_month, views
soundcloud current added_at, name, peak_position, position, track, likes, reposts
soundcloud past added_at, name, peak_position, position, removed_at, track, likes, reposts

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. PG aggregates (followers, fdiff_*, num_track) may surface as strings due to uncast COUNT/SUM.

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

    Chartmetric artist ID. Note: id=1 ('Various Artists') is rejected.

    • enum
      const:  
      1
      values
      • 1
  • platform
    Type: string enum
    required

    Streaming platform. One of spotify, applemusic, deezer, amazon, youtube, soundcloud. Supported boolean filters and sortColumn values vary by platform.

    values
    • spotify
    • applemusic
    • deezer
    • amazon
    • youtube
    • soundcloud
  • status
    Type: string enum
    required

    Playlist status. current returns playlists currently containing the artist's tracks; past returns playlists that previously did.

    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-01'). 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 playlist entries to return. Defaults to 10, max 100.

  • 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. Defaults to false.

  • sortColumn
    Type: string

    Column to sort playlists by. Allowed values depend on (platform, status) — see the platform-specific table in the apidoc.

  • sortOrderDesc
    Type: boolean

    If true, sort descending by sortColumn. Only valid when sortColumn is also defined.

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

{
  "obj": [
    {
      "playlist": {
        "playlist_id": "24rm8nmbUoNGOPmHuHo82X",
        "track_id": 130396669,
        "peak_position": 335,
        "position": 335,
        "cm_track": 111516408,
        "fdiff_month": 0,
        "added_at": "2023-10-04",
        "period": 19,
        "followers": 1,
        "track": "Bad Girls",
        "name": "Линочке",
        "playlist_image_url": "https://image-cdn-ak.spotifycdn.com/image/ab67706c0000bebba87504063ea6446e82dff60f",
        "code2": null,
        "curator_name": "Влад",
        "id": 15853738,
        "description": "Playlist description…",
        "image_url": "https://image-cdn-ak.spotifycdn.com/image/ab67706c0000bebba87504063ea6446e82dff60f",
        "sys_last_updated": "2023-10-19T00:00:00.000Z",
        "last_updated": "2023-10-19T20:26:31.000Z",
        "personalized": false,
        "owner_name": "Влад",
        "owner_id": 24259895,
        "user_id": "5xb0g5od6z0chmrv5z9txji2d",
        "editorial": false,
        "tags": [
          {
            "id": 462884,
            "name": "Rock"
          },
          {
            "id": 462888,
            "name": "Alternative"
          }
        ],
        "num_track": 344,
        "fdiff_week": 0,
        "catalog": "mixed",
        "active_ratio": 0.06686
      },
      "track": {
        "id": 130396669,
        "name": "Bad Girls",
        "isrc": "QZWDD2334631",
        "spotify_track_id": "5U6zdFSc5WJWr1E3O1f3T1",
        "spotify_album_id": "1W0rzr5HFU9b5hp8TMjk3T",
        "image_url": "https://i.scdn.co/image/ab67616d0000b273302fe5d2572cb5def4a5f9f2",
        "spotify_popularity": 0,
        "cm_track": 111516408,
        "spotify_artist_names": [
          "Lvvrs"
        ],
        "track_genre": null,
        "cm_artist": [
          1022311
        ],
        "artist_names": [
          "Lvvrs"
        ],
        "code2s": [
          "US"
        ],
        "artist_images": [
          "https://i.scdn.co/image/ab67616100005174e9691106aa3d936390cc799e"
        ],
        "artist_covers": [
          null
        ],
        "spotify_artist_ids": [
          "6VJa7asxiDZyqRa94XNRLA"
        ],
        "spotify_track_ids": [
          "5U6zdFSc5WJWr1E3O1f3T1"
        ],
        "spotify_album_ids": [
          "1W0rzr5HFU9b5hp8TMjk3T"
        ],
        "spotify_duration_ms": 175798,
        "album_ids": [
          30925539
        ],
        "album_names": [
          "Bad Girls"
        ],
        "album_upc": [
          "197773755869"
        ],
        "album_label": [
          "LVVRS"
        ],
        "release_dates": [
          "2023-09-15"
        ],
        "composer_name": null
      }
    }
  ]
}

Success