List YouTube 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
Type: stringenum

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

values
channel_subscriberschannel_viewsnum_playliststotal_playlist_views
sortOrderDesc
Type: boolean

If true, sort sortColumn in descending order. Defaults to true.
userListIds[]
Type: array of integer unique!
min:
0
max:
2147483647

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.
majorLabel
Type: boolean

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

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

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.
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.
audiobook
Type: boolean

If true, return only audiobook curators. If false, exclude them. Applies to spotify and youtube.

Responses

application/json

get/api/curator/youtube/lists

curl 'https://api.chartmetric.com/api/curator/youtube/lists?limit=50&sortColumn=channel_subscribers&sortOrderDesc=true' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

Show Schema

{
  "obj": [
    {
      "position": 1,
      "owner_id": "UC-9-kyTW8ZkZNDHQJ6FgpwQ",
      "url": "https://yt3.googleusercontent.com/...",
      "owner_name": "Music",
      "channel_views": 123456789,
      "channel_subscribers": 100000000,
      "total_playlist_views": 987654321,
      "num_playlists": 52,
      "tags": [
        "pop",
        "rock"
      ]
    }
  ],
  "offset": 0,
  "total": 1000
}

Success

List Spotify Curators

List Amazon Curators