CHchartmetric
Curator

List Spotify 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/spotify/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'num_playlists' | 'followers' | 'num_updates' | 'num_tracks_updated' | 'fdiff_month' | 'fdiff_percent_month' | 'sp_playlist_total_reach'

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.

withSocialUrlsboolean

If true, return only curators that have social URL data on file (URLs themselves are not included in the response). Applies to spotify only.

editorialboolean

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

majorLabelboolean

If true, return only major-label curators (Sony, Universal, Warner). If false, exclude them. Applies to spotify and youtube.

brandboolean

If true, return only curators associated with a brand. If false, exclude them. Applies to spotify and youtube.

popularIndieboolean

If true, return only popular indie curators (not editorial/brand/major-label, with 100K+ reached followers). If false, exclude them. Applies to spotify and youtube.

indieboolean

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

audiobookboolean

If true, return only audiobook curators. If false, exclude them. Applies to spotify 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.