List Playlist Tracks (Current or Past)

​

List tracks currently on or previously on a playlist, optionally enriched with artist/album/audio-feature details. Use span=current for active tracks, span=past for historical removals.

Path Parameters
  • id
    required

    Chartmetric playlist ID. Numeric for spotify/itunes/deezer/soundcloud; string for amazon/youtube.

    • Type: string

      Chartmetric playlist ID. Numeric for spotify/itunes/deezer/soundcloud; string for amazon/youtube.

  • platform
    Type: string enum
    required

    Streaming platform. One of spotify, itunes, deezer, amazon, youtube, soundcloud.

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

    Time span. current returns tracks currently on the playlist; past returns tracks that were on the playlist but have since been removed.

    values
    • current
    • past
Query Parameters
  • withDetails
    Type: boolean

    If true, hydrate each track with artist, album, and audio-feature details. Defaults to true.

  • since
    Type: string Format: date

    Only return tracks with removed_at after this date in YYYY-MM-DD format. Applies only to span=past.

  • until
    Type: string Format: date

    Only return tracks with added_at before this date in YYYY-MM-DD format. Applies only to span=past.

  • storefront
    Type: string
    min length:  
    2
    max length:  
    2

    ISO 3166-1 alpha-2 country code (2 letters, e.g. 'US', 'BR', 'GB').

  • version_only[]
    Type: array string[] enum

    Filter to tracks where ONLY the specified version cluster types are true and all others are false. Cannot be combined with version_and, version_or, or version_not.

    values
    • original
    • re_release
    • edit
    • remix
    • acoustic
  • version_and[]
    Type: array string[] enum

    Filter to tracks that contain ALL of the specified version cluster types. Cannot be combined with version_or.

    values
    • original
    • re_release
    • edit
    • remix
    • acoustic
  • version_or[]
    Type: array string[] enum

    Filter to tracks that contain AT LEAST ONE of the specified version cluster types. Cannot be combined with version_and.

    values
    • original
    • re_release
    • edit
    • remix
    • acoustic
  • version_not[]
    Type: array string[] enum

    Filter to tracks that contain NONE of the specified version cluster types.

    values
    • original
    • re_release
    • edit
    • remix
    • acoustic
  • limit
    Type: integer
    min:  
    1
    max:  
    1000

    Maximum number of items to return per request.

  • offset
    Type: integer
    min:  
    0

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

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

{
  "obj": [
    {
      "track_id": 16979872,
      "isrc": "USWD11994667",
      "added_at": "2020-01-22T00:00:00.000Z",
      "position": 1,
      "period": 334,
      "id": 16979872,
      "name": "Into the Unknown",
      "spotify_album_id": "4M07HWIlZr7zoXoxDHR5mz",
      "image_url": "https://i.scdn.co/image/43c6b410f1bc66fac51d61f36e3149b29b3f25f1",
      "spotify_popularity": 79,
      "cm_track": 27031598,
      "spotify_artist_names": [
        "Idina Menzel",
        "AURORA"
      ],
      "track_genre": "broadway,hollywood,movie tunes,show tunes,norwegian pop,pop",
      "cm_artist": [
        1805,
        5172
      ],
      "artist_names": [
        "Idina Menzel",
        "AURORA"
      ],
      "code2s": [
        "US",
        "NO"
      ],
      "artist_images": [
        "https://i.scdn.co/image/e303c5a39e4da4f7c40f1b6ccc1209795c9199d0",
        "https://i.scdn.co/image/a3ade0a92bb3c99514fb8d017024a7d9df1572b1"
      ],
      "artist_covers": [
        null,
        null
      ],
      "spotify_artist_ids": [
        "73Np75Wv2tju61Eo9Zw4IR",
        "1WgXqy2Dd70QQOU7Ay074N"
      ],
      "spotify_track_ids": [
        "3Z0oQ8r78OUaHvGPiDBR3W"
      ],
      "spotify_album_ids": [
        "4M07HWIlZr7zoXoxDHR5mz"
      ],
      "spotify_duration_ms": 194848,
      "album_ids": [
        5357061
      ],
      "album_names": [
        "Frozen 2 (Original Motion Picture Soundtrack/Deluxe Edition)"
      ],
      "album_upc": [
        "050087433390"
      ],
      "album_label": [
        "Walt Disney Records"
      ],
      "release_dates": [
        "2019-11-15T00:00:00.000Z"
      ],
      "audio_features": {
        "key": 10,
        "mode": 0,
        "danceability": "0.323",
        "energy": "0.405",
        "speechiness": "0.0413",
        "acousticness": "0.849",
        "instrumentalness": "0.000544",
        "liveness": "0.138",
        "valence": "0.274",
        "tempo": "145.104",
        "loudness": "-8.533"
      },
      "position_stats": []
    }
  ]
}

Success