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

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

Boolean flag parameters supported per platform:

Flag	spotify	applemusic	deezer
`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 track ID.
platform
Type: string enum
required

Streaming platform. One of spotify, applemusic (aliased to itunes), deezer, amazon, soundcloud.
values
- spotify
- applemusic
- deezer
- amazon
- soundcloud
status
Type: string enum
required

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

Query Parameters

since
Type: string Format: date

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

Inclusive end of the added/removed-at date range in YYYY-MM-DD format. 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 playlists to return. 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).
sortColumn
Type: string

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

If true, sort descending by sortColumn. Only valid when sortColumn is set. Defaults to true.
minFollowers
Type: integer

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

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

Responses

application/json

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

curl https://api.chartmetric.com/api/track/0/spotify/current/playlists \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

Show Schema

{
  "obj": [
    {
      "playlist": {
        "playlist_id": "37i9dQZF1DWTkxQvqMy4WW",
        "id": 1635107,
        "name": "Chillin' on a Dirt Road",
        "description": "Country music to get you back to the basics.",
        "image_url": "https://i.scdn.co/image/ab67706f00000003ac122bacaf283ff31b362030",
        "sys_last_updated": "2023-10-24T00:00:00.000Z",
        "last_updated": "2023-10-24T00:40:14.000Z",
        "personalized": true,
        "code2": "US",
        "owner_name": "Spotify",
        "owner_id": 2,
        "user_id": "spotify",
        "editorial": false,
        "tags": [
          {
            "id": 462895,
            "name": "Country"
          },
          {
            "id": 462882,
            "name": "Pop"
          }
        ],
        "followers": 3337655,
        "num_track": 100,
        "fdiff_week": 3631,
        "fdiff_month": 4528,
        "catalog": "catalogue ",
        "active_ratio": 0.83
      },
      "track": {
        "id": 4445159,
        "name": "What Ifs (feat. Lauren Alaina)",
        "isrc": "USRN11600859",
        "image_url": "https://i.scdn.co/image/3c29df3f40b15",
        "spotify_popularity": 75,
        "cm_track": 15711334,
        "spotify_artist_names": [
          "Kane Brown",
          "Lauren Alaina"
        ],
        "track_genre": "contemporary country,country",
        "cm_artist": [
          5408,
          3836
        ],
        "artist_names": [
          "Kane Brown",
          "Lauren Alaina"
        ],
        "code2s": [
          "US",
          "US"
        ],
        "artist_images": [
          "https://i.scdn.co/image/ab676161000051747b44d30c0a151c78d3c0bcaa",
          "https://i.scdn.co/image/ab6761610000517430be9c1d7921b1229c8b36ad"
        ],
        "spotify_artist_ids": [
          "3oSJ7TBVCWMDMiYjXNiCKE",
          "1v3tdpIdBSW14rHUfiEVOv"
        ],
        "spotify_track_ids": [
          "7zVCrzzEJU7u24sbJPXA5W"
        ],
        "spotify_album_ids": [
          "4hhvgHjPqUOAYkclDkhL2T"
        ],
        "spotify_duration_ms": 188253,
        "album_ids": [
          1780125
        ],
        "album_names": [
          "Kane Brown"
        ],
        "album_upc": [
          "886445733945"
        ],
        "album_label": [
          "RCA Records Label Nashville"
        ],
        "release_dates": [
          "2016-12-02"
        ]
      }
    }
  ]
}

Success