---
title: "List Curator Playlists"
method: GET
path: "/api/curator/{platform}/{id}/playlists"
tags: ["Curator"]
---

# List Curator Playlists

`GET /api/curator/{platform}/{id}/playlists`

## Request

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

Get playlists created by a curator. Sort columns by platform: `spotify` — `last_updated`, `followers` (default), `num_track`; `applemusic` — `last_updated` (default), `num_track`; `deezer` — `last_updated` (default), `followers`, `num_track`.

## Path parameters

- `platform` 'cm' | 'spotify' | 'itunes' | 'applemusic' | 'deezer' | 'shazam' | 'beatport' | 'amazon' | 'youtube' | 'tunefind' | 'soundcloud', required: Streaming platform. Curator playlists are supported on `spotify`, `applemusic`, `deezer`.
- `id` integer, required: Chartmetric curator ID.

## Query parameters

- `storefront` string: ISO 3166-1 alpha-2 country code (2 letters, e.g. 'US', 'BR', 'GB').
- `limit` integer: Maximum number of items to return per request.
- `offset` integer: Number of items to skip from the start of the result set; pair with `limit` to paginate.
- `sortColumn` union: Column to sort playlists by. Allowed values vary per platform — see the operation description for the per-platform list.
  - 'last_updated' | 'followers' | 'num_track'
  - 'last_updated' | 'num_track'
  - 'last_updated' | 'num_track' | 'followers'
- `sortOrderDesc` boolean: If true, sort `sortColumn` in descending order. Only allowed when `sortColumn` is set. Defaults to true.

## Response `200`

Success

- object
  - `total_length` union: Total number of playlists matching the request across all pages.
    - integer
    - string
  - `length` integer, required: Number of playlists returned in this response page.
  - `data` object[], required: List of playlists owned by the curator.
    - `id` union, required: Chartmetric playlist ID.
      - integer
      - string
    - `name` string, nullable: Playlist name.
    - `playlist_id` string, nullable: Platform-side playlist ID (e.g. Spotify URI tail).
    - `description` string, nullable: Free-form playlist description from the platform.
    - `image_url` string, nullable: URL of the playlist cover image.
    - `sys_last_updated` string, date-time, nullable: ISO timestamp of the most recent Chartmetric crawl of this playlist.
    - `last_updated` string, date-time, nullable: ISO timestamp of the most recent platform-side update to this playlist.
    - `personalized` boolean, nullable: True if the playlist is personalized per listener (e.g. Discover Weekly).
    - `code2` string, nullable: ISO 3166-1 alpha-2 country code associated with the playlist (lowercase).
    - `owner_name` string, nullable: Display name of the playlist's owner.
    - `owner_id` union: Chartmetric ID of the playlist owner.
      - integer
      - string
    - `user_id` union: Platform-side ID of the playlist owner.
      - string
      - integer
    - `official` boolean, nullable: True if the playlist is an official platform editorial playlist.
    - `tags` object[], nullable: Genre tags applied to the playlist.
      - `id` integer, required: Chartmetric genre tag ID.
      - `name` string, required: Genre tag name.
    - `followers` integer, nullable: Playlist follower count on the platform.
    - `num_track` union: Number of tracks currently on the playlist.
      - integer
      - string
    - `fdiff_week` integer, nullable: Net change in followers vs. 7 days ago.
    - `fdiff_month` integer, nullable: Net change in followers vs. 28 days ago.
    - `catalog` string, nullable: Track-catalog mix of the playlist (e.g. 'frontline', 'catalogue', 'mixed').
    - `active_ratio` number, float, nullable: Fraction of the playlist tracks that are currently active (0–1).

---

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