List Amazon 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).

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:  
    total_playlists

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

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

  • editorial
    Type: boolean

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

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

{
  "obj": [
    {
      "position": 1,
      "total_playlists": 1200,
      "owner_id": 42,
      "owner_name": "Amazon Music",
      "tags": [
        "Pop",
        "Rock"
      ]
    }
  ],
  "offset": 0,
  "total": 200
}

Success