---
title: "Album Metadata"
method: GET
path: "/api/album/{id}"
tags: ["Album"]
---

# Album Metadata

`GET /api/album/{id}`

## Request

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

Album metadata by Chartmetric ID.

## Path parameters

- `id` integer, required: Chartmetric album ID.

## Response `200`

Success

- object
  - `obj` object
    - `id` integer, nullable: Chartmetric album ID. Same value as `cm_album`.
    - `upc` string, nullable: Universal Product Code identifying the release.
    - `name` string, nullable: Album name.
    - `local_name` string, nullable: Localized album name, when available.
    - `local_name_locale` string, nullable: Locale for local_name, when available.
    - `image_url` string, nullable: Album cover image URL.
    - `release_date` string, nullable: Album release date (`YYYY-MM-DD`).
    - `label` string, nullable: Record label that released the album.
    - `distributor` string, nullable: Distributor of the release, when known. `null` until the album has been looked up or when no distributor was found.
    - `spotify_popularity` integer, nullable: Spotify popularity score (0–100) at the time of caching.
    - `cm_label` integer, nullable: Chartmetric label ID.
    - `description` string, nullable: Album description.
    - `created_at` string, date-time, nullable: Date the album row was created in Chartmetric.
    - `modified_at` string, date-time, nullable: Date the album row was last modified in Chartmetric.
    - `cm_album` integer, required: Chartmetric album ID.
    - `num_track` union: Number of tracks on the album.
      - string
      - number, float
    - `spotify_album_ids` string[], nullable: Spotify album IDs associated with this album.
    - `itunes_album_ids` string[], nullable: iTunes album IDs associated with this album.
    - `deezer_album_ids` string[], nullable: Deezer album IDs associated with this album.
    - `artists` object[], nullable: Artists credited on the album.
      - `cm_artist` integer, nullable: Chartmetric artist ID.
      - `name` string, nullable: Artist name.
      - `image_url` string, nullable: Artist image URL.
    - `cm_statistics` object, nullable: Cached playlist statistics for the album.
      - `sp_popularity` integer, nullable: Spotify popularity score (0–100).
      - `num_sp_editorial_playlists` integer, nullable: Count of Spotify editorial playlists featuring this album.
      - `num_sp_playlists` integer, nullable: Count of Spotify playlists featuring this album.
      - `sp_playlist_total_reach` integer, nullable: Sum of followers across all Spotify playlists featuring this album.
      - `sp_editorial_playlist_total_reach` integer, nullable: Sum of followers across all Spotify editorial playlists featuring this album.

---

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