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

# Get Playlist Metadata

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

## Request

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

Fetch metadata for a Chartmetric playlist on a streaming platform. Response shape varies slightly per platform; follower counts may exceed the 32-bit range.

## Path parameters

- `id` union, required: Chartmetric playlist ID. Numeric for `spotify`, `itunes`/`applemusic`, and `deezer`; string (e.g. ASIN, channel ID) for `amazon`, `youtube`, and `soundcloud`.
  - integer
  - unknown
- `platform` 'cm' | 'spotify' | 'itunes' | 'applemusic' | 'deezer' | 'shazam' | 'beatport' | 'amazon' | 'youtube' | 'tunefind' | 'soundcloud', required: Streaming platform. One of `spotify`, `applemusic` (aliased to `itunes`), `itunes`, `deezer`, `amazon`, `youtube`, `soundcloud`.

## Query parameters

- `storefront` string: ISO 3166-1 alpha-2 country code (2 letters, e.g. 'US', 'BR', 'GB').

## Response `200`

Success

- object
  - `obj` object, nullable
    - `id` integer, required: Chartmetric playlist ID.
    - `name` string, nullable: Playlist name.
    - `playlist_id` string, nullable: Platform-native playlist ID (e.g. Spotify URI suffix).
    - `description` string, nullable: Playlist description as set by the curator.
    - `image_url` string, nullable: Cover image URL.
    - `sys_last_updated` string, date-time, nullable: Date when Chartmetric last refreshed playlist data.
    - `last_updated` string, date-time, nullable: Date when the playlist was last observed updated on the platform.
    - `personalized` boolean: Whether the playlist is personalized (varies per listener).
    - `code2` string, nullable: Country code associated with the playlist as ISO 3166-1 alpha-2 (e.g. 'US').
    - `owner_name` string, nullable: Display name of the playlist owner.
    - `owner_id` union: Chartmetric curator (owner) ID for the playlist.
      - integer
      - string
    - `user_id` union: Platform-native owner/user ID (e.g. Spotify user ID).
      - integer
      - string
    - `editorial` boolean: Whether the playlist is curated by an official editorial team. Applies mainly to Spotify, Apple Music, and Deezer.
    - `tags` object[], nullable: List of tags/genres on the playlist.
      - `id` integer, required: Chartmetric tag/genre ID.
      - `name` string, required: Tag/genre name.
      - `source` string, nullable: Source of the tag (e.g. `spotify`).
      - `type` string, nullable: Tag type (e.g. `genre`, `mood`).
      - `url` string, nullable: Optional URL associated with the tag.
      - `created_at` string, date-time, nullable: When the tag association was first observed.
      - `modified_at` string, date-time, nullable: When the tag association was last updated.
    - `followers` integer, nullable: Current follower/fan count of the playlist. May exceed the 32-bit range on Spotify/Deezer.
    - `likes` integer, nullable: Current like count of the playlist (SoundCloud).
    - `num_track` union: Total number of tracks currently on the playlist.
      - integer
      - string
    - `fdiff_week` integer, nullable: Difference in followers/likes vs. one week ago (weekly net growth).
    - `fdiff_month` integer, nullable: Difference in followers/likes vs. one month ago (monthly net growth).
    - `catalog` string, nullable: Catalog classification of the playlist tracks (e.g. `frontline`, `catalogue`, `mixed`).
    - `active_ratio` number, float, nullable: Ratio (0–1) measuring how actively the playlist is being updated.
    - `new_sp_id` string, nullable: New Spotify playlist ID if the playlist has been transferred to a new owner.
    - `moods` object[], nullable: List of moods associated with the playlist.
      - `id` integer, required: Chartmetric mood ID.
      - `name` string, nullable: Mood name (e.g. `Chill`, `Energetic`).
    - `activities` object[], nullable: List of activities associated with the playlist.
      - `id` integer, required: Chartmetric mood ID.
      - `name` string, nullable: Mood name (e.g. `Chill`, `Energetic`).
    - `genres` object[], nullable: List of genres associated with the playlist.
      - `id` integer, required: Chartmetric genre ID.
      - `name` string, nullable: Genre name.

---

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