Get Playlist Evolution by Artist, Album, or Track

​

Daily playlist-count and total-reach time series across six streaming platforms for the given entity (artist, album, or track). iTunes, Amazon, and SoundCloud only expose counts (no reach). Reach numbers can exceed the 32-bit range.

Path Parameters
  • id
    Type: integer
    required

    Chartmetric metadata ID for the entity selected by type (artist, album, or track ID).

  • type
    Type: string enum
    required

    Chartmetric metadata type. One of artist, album, or track.

    values
    • artist
    • track
    • album
Query Parameters
  • since
    Type: string Format: date

    Inclusive start of the date range in YYYY-MM-DD format. Defaults to 180 days before today.

  • until
    Type: string Format: date

    Inclusive end of the date range in YYYY-MM-DD format. Defaults to today.

Responses
  • application/json
Request Example for get/api/playlist/by/{type}/{id}/evolution
curl https://api.chartmetric.com/api/playlist/by/artist/1/evolution \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

{
  "obj": {
    "spotify": [
      {
        "created_at": "2018-12-01",
        "playlist_count": 1095,
        "ed_playlist_count": 8,
        "playlist_total_reach": 4296113,
        "ed_playlist_total_reach": 3383510
      }
    ],
    "amazon": [],
    "deezer": [],
    "youtube": [],
    "itunes": [
      {
        "created_at": "2018-12-01",
        "playlist_count": 15,
        "ed_playlist_count": 3
      }
    ],
    "soundcloud": []
  }
}

Success