---
title: "List iTunes Curators"
method: GET
path: "/api/curator/itunes/lists"
tags: ["Curator"]
---

# List iTunes Curators

`GET /api/curator/itunes/lists`

## Request

- Base URL: `https://api.chartmetric.com`
- URL: `https://api.chartmetric.com/api/curator/itunes/lists`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/chartmetric/apis/chartmetric-developer-api/docs/api/curator/itunes/lists/get.ts> (a function with typed inputs; its response is checked against the schema)

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

## Query parameters

- `offset` integer: 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` integer: Maximum number of curators to return per request. Defaults to 50; max 10000. `offset + limit` must be ≤ 10,000.
- `sortColumn` 'num_playlists': Column to sort curators by. Allowed values vary per platform; see the endpoint description for the list. Default also varies per platform.
- `sortOrderDesc` boolean: 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`.
- `nameSearch` string: Substring match against curator name.
- `playlistKeywordSearch` string: Substring match against names of playlists owned by the curator.
- `code2` string: ISO 3166-1 alpha-2 country code (2 letters, e.g. 'US', 'BR', 'GB').
- `editorial` boolean: If true, return only official platform editorial curators. If false, exclude them. Applies to `spotify`, `applemusic`, `amazon`, and `youtube`.
- `indie` 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`.

## Response `200`

Success

- object
  - `obj` object[], required: List of curator entries for the requested platform.
    - `position` integer, nullable: 1-based rank of the curator within the entire sorted result set (i.e. `index + 1 + offset`).
    - `owner_id` union: Chartmetric curator ID. Numeric for `spotify`, `applemusic`, `itunes`, `deezer`, `amazon`; string for `youtube` (channel ID).
      - integer
      - string
    - `owner_name` string, nullable: Curator display name.
    - `url` string, nullable: Image or profile URL for the curator on the platform.
    - `code2` string, nullable: ISO 3166-1 alpha-2 country code associated with the curator (lowercase, e.g. 'us', 'gb'). Populated for `applemusic`, `itunes`, `deezer`, `youtube`.
    - `tags` string[], nullable: Genre tags associated with the curator.
    - `num_playlists` integer, nullable: Count of the curator's playlists tracked by Chartmetric.
    - `user_id` string, nullable: Platform-side user ID (Spotify user).
    - `sp_playlist_total_reach` integer, nullable: Sum of followers across all of this Spotify curator's playlists (total playlist reach). Spotify only.
    - `followers` integer, nullable: Curator's follower count on the platform.
    - `fdiff_month` integer, nullable: Net change in followers vs. 28 days ago. Spotify only.
    - `fdiff_percent_month` number, float, nullable: Percentage change in followers vs. 28 days ago, expressed as a fraction (e.g. 0.0139 = +1.39%). Spotify only.
    - `num_updates` integer, nullable: Number of updates the curator has made across their playlists. Spotify only.
    - `num_tracks_updated` integer, nullable: Number of tracks added/removed across the curator's recent playlist updates. Spotify only.
    - `editorial` boolean, nullable: True if this is an official platform editorial curator.
    - `major_label` boolean, nullable: True if the curator is operated by a major label (Sony, Universal, Warner).
    - `brand` boolean, nullable: True if the curator is operated by a brand.
    - `popular_indie` boolean, nullable: True if the curator is a popular indie (not editorial/brand/major-label, with 100K+ reached followers).
    - `indie` boolean, nullable: True if the curator is independent (not editorial, brand, major-label, or popular indie).
    - `audiobook` boolean, nullable: True if the curator focuses on audiobook content.
    - `suspicion_score` number, float, nullable: Chartmetric suspicion score flagging potentially inauthentic activity (lower is cleaner). Spotify only.
    - `total_reach` integer, nullable: Sum of followers across all of this curator's Deezer playlists. Deezer only.
    - `total_playlists` integer, nullable: Total number of playlists owned by this curator on Amazon Music. Amazon only.
    - `curator_id` union: Platform-side curator ID on Apple Music / iTunes.
      - integer
      - string
    - `channel_views` integer, nullable: Cumulative views across the curator's YouTube channel. YouTube only.
    - `channel_subscribers` integer, nullable: Subscriber count for the curator's YouTube channel. YouTube only.
    - `total_playlist_views` integer, nullable: Sum of views across all of the curator's YouTube playlists. YouTube only.
  - `offset` integer, nullable: Offset of this result page (echoes the `offset` request param).
  - `total` union: Total number of curators matching the filters across all pages.
    - integer
    - string

---

[API](https://skmtc.dev/chartmetric/apis/chartmetric-developer-api.md) - [All operations](https://skmtc.dev/chartmetric/apis/chartmetric-developer-api/llms.txt) - [OpenAPI document](https://skmtc.dev/chartmetric/apis/chartmetric-developer-api/revisions/94dac96833a3?raw)