Get Track Playlist Snapshot by Date

​

Return the playlists a track belonged to on the given date. platform accepts spotify, applemusic (aliased to itunes), or deezer. Each entry pairs the playlist info with the track info at that snapshot.

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), or deezer.

    values
    • spotify
    • applemusic
    • itunes
    • deezer
Query Parameters
  • date
    Type: string Format: date-time
    required

    Snapshot date in YYYY-MM-DD format. Returns playlists the track was on as of this date.

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

Responses
  • application/json
Request Example for get/api/track/{id}/{platform}/playlists/snapshot
curl 'https://api.chartmetric.com/api/track/0/spotify/playlists/snapshot?date=' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

{
  "obj": [
    {
      "playlist_id": 688460,
      "track_id": 9874724,
      "added_at": "2018-09-27T00:00:00.000Z",
      "removed_at": "2020-02-09T08:11:39.008Z",
      "playlist": {
        "id": 688460,
        "name": "NEW POP HITS 2014-HEUTE",
        "playlist_id": "6JjPdcrvR4l6ZAoga2EFqh",
        "description": "NEW POP HITS 2014-HEUTE (Daily Updated Music) by DjCK",
        "image_url": "https://i.scdn.co/image/ab67706c0000bebb198fdd7caeedd2d8517f35c7",
        "sys_last_updated": "2020-12-21T20:40:25.686Z",
        "last_updated": "2020-12-21T20:40:17.114Z",
        "personalized": false,
        "code2": null,
        "owner_name": "Christian Kreitz",
        "owner_id": 11781,
        "user_id": "1156916120",
        "editorial": false,
        "tags": [
          {
            "id": 188,
            "name": "pop"
          },
          {
            "id": 8893,
            "name": "dance pop"
          }
        ],
        "followers": 3,
        "num_track": "3056",
        "fdiff_week": 0,
        "fdiff_month": 0,
        "catalog": "catalogue ",
        "active_ratio": 0.032068
      },
      "track": {
        "id": 9874724,
        "name": "Taki Taki (with Selena Gomez, Ozuna & Cardi B)",
        "isrc": "USUG11801723",
        "image_url": "https://i.scdn.co/image/cca02c139eb4270d5e396086329c97c782c7b478",
        "spotify_popularity": 80,
        "cm_track": 20614006,
        "spotify_artist_names": [
          "DJ Snake",
          "Selena Gomez"
        ],
        "track_genre": "dance pop,pop",
        "cm_artist": [
          4310,
          3168
        ],
        "artist_names": [
          "DJ Snake",
          "Selena Gomez"
        ],
        "code2s": [
          "FR",
          "US"
        ],
        "artist_images": [
          "https://i.scdn.co/image/3b232935a2d2dc1fcc3bfd8db2d6be58292b2317",
          "https://i.scdn.co/image/61fc36467d4945514cdf052ed49286aa8ea3b4fc"
        ],
        "artist_covers": [
          null,
          null
        ],
        "spotify_artist_ids": [
          "540vIaP2JwjQb9dm3aArA4",
          "0C8ZW7ezQVs4URX5aX7Kqx"
        ],
        "spotify_track_ids": [
          "4w8niZpiMy6qz1mntFA5uM"
        ],
        "spotify_album_ids": [
          "0ZHyvPke0EcVt6rYA8Ins3"
        ],
        "spotify_duration_ms": 212500,
        "album_ids": [
          2812303
        ],
        "album_names": [
          "Taki Taki (with Selena Gomez, Ozuna & Cardi B)"
        ],
        "album_upc": [
          "602577004803"
        ],
        "album_label": [
          "DJ Snake Music Productions Limited, under exclusive license to Geffen Records"
        ],
        "release_dates": [
          "2018-09-28T00:00:00.000Z"
        ]
      }
    }
  ]
}

Success