List Curators by Platform

​

List curators by platform. Sort columns vary by platform: spotify — num_playlists (default), followers, num_updates, num_tracks_updated, fdiff_month, fdiff_percent_month, sp_playlist_total_reach; applemusic/itunes — num_playlists (default); deezer — num_playlists, total_reach (default); youtube — total_playlist_views (default), num_playlists, channel_views, channel_subscribers; amazon — total_playlists (default). This catch-all endpoint returns HTTP 400 when platform is not one of applemusic, deezer, itunes, spotify, youtube, amazon. For valid platforms, use the platform-specific list route (e.g. /api/curator/spotify/lists).

Path Parameters
  • platform
    Type: string
    required

    Streaming platform. Fallback route — any value not in [spotify, applemusic, itunes, deezer, youtube, amazon] returns HTTP 400 with the list of valid platforms.

Responses
  • application/json
Request Example for get/api/curator/{platform}/lists
curl 'https://api.chartmetric.com/api/curator/{platform}/lists' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

{
  "obj": [
    {
      "position": 1,
      "user_id": "spotify",
      "owner_id": 2,
      "owner_name": "Spotify",
      "url": "https://i.scdn.co/image/ab6775700000ee8555c25988a6ac314394d3fbf5",
      "num_playlists": 138039,
      "sp_playlist_total_reach": 2793372862,
      "followers": 11213310,
      "fdiff_month": 113368,
      "fdiff_percent_month": 0.013958,
      "tags": [
        "pop",
        "hip-hop/rap",
        "rock"
      ],
      "num_updates": 0,
      "num_tracks_updated": 0,
      "editorial": true,
      "major_label": false,
      "brand": false,
      "popular_indie": false,
      "indie": false,
      "audiobook": true
    }
  ],
  "offset": 0,
  "total": 2712006
}

Success