---
title: "Get Curator Metadata"
method: GET
path: "/api/curator/{platform}/{id}"
tags: ["Curator"]
---

# Get Curator Metadata

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

## Request

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

Get a curator's metadata (name, image, tags, cross-platform social stats) by `platform` and Chartmetric `id`. Supported platforms: `spotify`, `applemusic`, `deezer`, `amazon`, `youtube`.

## Path parameters

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

## Response `200`

Success

- object
  - `obj` object, required
    - `id` union, required: Chartmetric curator ID.
      - integer
      - string
    - `user_id` union: Platform-side user/channel ID (e.g. Spotify user, YouTube channel ID, Deezer user).
      - string
      - integer
    - `name` string, nullable: Curator display name.
    - `description` string, nullable: Free-form curator description (Apple Music only; null on other platforms).
    - `image_url` string, nullable: URL of the curator's profile image.
    - `code2` string, nullable: ISO 3166-1 alpha-2 country code associated with the curator (lowercase). Populated for Apple Music and Deezer.
    - `last_updated` string, date-time, nullable: ISO timestamp of the curator's most recent metadata refresh.
    - `tag_ids` integer[], nullable: Chartmetric genre tag IDs for this curator (positionally aligned with `tag_names`).
    - `tag_names` string[], nullable: Genre tag names for this curator (positionally aligned with `tag_ids`).
    - `groover_url` string, nullable: Groover submission URL for this curator, when one is registered.
    - `cm_statistics` object, nullable: Aggregated playlist statistics for this curator. Field set varies per platform.
      - `num_sp_playlists` integer, nullable: Number of Spotify playlists owned by this curator.
      - `sp_followers` integer, nullable: Curator's Spotify follower count.
      - `max_sp_playlist_followers` integer, nullable: Maximum follower count among the curator's Spotify playlists.
      - `sp_playlist_total_reach` integer, nullable: Sum of followers across all of the curator's Spotify playlists.
      - `num_itunes_playlists` integer, nullable: Number of Apple Music / iTunes playlists owned by this curator.
      - `num_de_playlists` integer, nullable: Number of Deezer playlists owned by this curator.
    - `tags` object[], nullable: Genre tags as `{id, name}` objects.
      - `id` integer, required: Chartmetric genre tag ID.
      - `name` string, required: Genre tag name.
    - `instagram_followers` union: Instagram follower count for the curator's linked account.
      - integer
      - string
    - `soundcloud_followers` integer, nullable: SoundCloud follower count for the curator's linked account.
    - `facebook_fans` integer, nullable: Facebook page fans (likes) for the curator's linked page.
    - `facebook_followers` integer, nullable: Facebook page followers for the curator's linked page.
    - `youtube_views` union: Cumulative view count across the curator's YouTube channel.
      - integer
      - string
    - `youtube_subscribers` integer, nullable: Subscriber count for the curator's YouTube channel.
    - `twitter_followers` integer, nullable: Twitter/X follower count for the curator's linked account.
    - `twitter_retweets` integer, nullable: Cumulative retweet count for the curator's linked Twitter/X account.
    - `tiktok_likes` union: Cumulative like count across the curator's TikTok account.
      - integer
      - string
    - `tiktok_followers` integer, nullable: TikTok follower count for the curator's linked account.
    - `spotifySocialUrls` object[], nullable: Spotify-discovered social URLs for the curator (e.g. linked Instagram, Twitter). Spotify only.
    - `storefronts` string, nullable: Comma-separated list of Apple Music storefront codes where this curator is available. Apple Music only.
    - `num_itunes_playlists` integer, nullable: Number of Apple Music / iTunes playlists owned by this curator. Apple Music only.

---

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