List Apple Music Curators

​

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). Note: applemusic and itunes return the same data.

Query Parameters
  • offset
    Type: integer
    min:  
    0
    max:  
    10000

    Number of items to skip from the start of the result set; pair with limit to paginate. offset + limit must be ≤ 10,000 (Elasticsearch window).

  • limit
    Type: integer
    min:  
    1
    max:  
    0

    Maximum number of curators to return per request. Defaults to 50; max 10000. offset + limit must be ≤ 10,000.

  • sortColumn
    enum
    const:  
    num_playlists

    Column to sort curators by. Allowed values vary per platform; see the endpoint description for the list. Default also varies per platform.

    values
    • num_playlists
  • sortOrderDesc
    Type: boolean

    If true, sort sortColumn in descending order. Defaults to true.

  • userListIds[]
    Type: array integer[] unique!

    Filter by Chartmetric shortlist (user list) IDs the curator is included on. Public API exposes this as shortlistIds.

  • nameSearch
    Type: string

    Substring match against curator name.

  • playlistKeywordSearch
    Type: string

    Substring match against names of playlists owned by the curator.

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

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

  • editorial
    Type: boolean

    If true, return only official platform editorial curators. If false, exclude them. Applies to spotify, applemusic, amazon, and youtube.

  • indie
    Type: boolean

    If true, include curators that are not major-label, editorial, brand, or popular indie. If false, exclude them. Applies to spotify, applemusic, and youtube.

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

{
  "obj": [
    {
      "owner_id": 1,
      "owner_name": "Apple Music",
      "url": "https://is1-ssl.mzstatic.com/image/thumb/Features126/v4/...jpg",
      "code2": "us",
      "curator_id": 976439548,
      "num_playlists": 2500,
      "tags": [
        "Pop",
        "Rock"
      ]
    }
  ],
  "offset": 0,
  "total": 500
}

Success