Get Playlist Stats Over Time

Time series of playlist audience stats (Spotify followers / Deezer fans / YouTube views / SoundCloud likes) over a date range.

Path Parameters
  • id
    required

    Chartmetric playlist ID (not the platform-native ID). Numeric for spotify/deezer; string for youtube/soundcloud.

  • platform
    Type: string enum
    required

    Streaming platform. One of spotify, deezer, youtube, soundcloud. Stat type varies by platform: Spotify followers, Deezer fans, YouTube views, SoundCloud likes.

    values
    • spotify
    • deezer
    • youtube
    • soundcloud
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/{platform}/{id}/stats
curl https://api.chartmetric.com/api/playlist/spotify/null/stats \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'
{
  "obj": [
    {
      "id": 93878425,
      "value": 6527755,
      "timestp": "Thu Oct 10 2019",
      "daily_diff": 0,
      "interpolated": false
    }
  ]
}