---
title: "Album Platform Stats"
method: GET
path: "/api/album/{id}/{platform}/{stats}"
tags: ["Album"]
---

# Album Platform Stats

`GET /api/album/{id}/{platform}/{stats}`

## Request

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

Time-series of a platform-specific stat for an album (currently `platform=spotify`, `stat=followers` returns Spotify popularity). Pass `latest=true` to bypass the date window and receive the most recent point.

## Path parameters

- `platform` 'spotify', required: Streaming platform whose stat is requested. Currently only `spotify` is supported.
- `stats` 'followers', required: Platform stat to retrieve. Currently only `followers` is supported (returns Spotify popularity).
- `id` integer, required: Chartmetric album ID.

## Query parameters

- `since` string, date: Start of the date window in ISO format (e.g. '2025-11-01'). Defaults to 180 days ago.
- `until` string, date: End of the date window in ISO format (e.g. '2025-11-15'). Defaults to today.
- `latest` boolean: If true, returns only the most recent data point and ignores the `since`/`until` window.

## Response `200`

Success

- object
  - `obj` object[], required
    - `value` number, float, required: Stat value at `timestp`. Despite the path slug `followers`, the value returned for `platform=spotify` is the Spotify album popularity (0–100), not a follower count.
    - `timestp` string, date-time, required: Timestamp the data point was recorded.
    - `daily_diff` number, float: Change in `value` versus the previous day.
    - `weekly_diff` number, float: Change in `value` versus 7 days prior.
    - `monthly_diff` number, float: Change in `value` versus 30 days prior.
    - `weekly_diff_percent` number, float: Percent change in `value` versus 7 days prior.
    - `monthly_diff_percent` number, float: Percent change in `value` versus 30 days prior.
    - `flags` boolean: True when this point carries data-quality flags.
    - `interpolated` boolean: True when the value was interpolated from neighboring points.
    - `extrapolated` boolean: True when the value was extrapolated beyond the source series.

---

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