CHchartmetric
Curator

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

get/api/curator/amazon/lists

Request

Query parameters

offsetinteger

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

limitinteger

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

sortColumn'total_playlists'

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

sortOrderDescboolean

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

userListIds[]integer[]

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

nameSearchstring

Substring match against curator name.

playlistKeywordSearchstring

Substring match against names of playlists owned by the curator.

editorialboolean

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

Response

Success

offsetinteger nullable

Offset of this result page (echoes the offset request param).

Changes

No recorded changes to this operation across all 1 revision of this API.