---
title: "Get Playlist Stats Over Time"
method: GET
path: "/api/playlist/{platform}/{id}/stats"
tags: ["Playlist"]
---

# Get Playlist Stats Over Time

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

## Request

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

Time series of playlist audience stats (Spotify followers / Deezer fans / YouTube views / SoundCloud likes) over a date range.

## Path parameters

- `id` union, required: Chartmetric playlist ID (not the platform-native ID). Numeric for `spotify`/`deezer`/`soundcloud`; string for `youtube`.
  - string
  - integer
- `platform` 'spotify' | 'deezer' | 'youtube' | 'soundcloud', required: Streaming platform. One of `spotify`, `deezer`, `youtube`, `soundcloud`. Stat type varies by platform: Spotify followers, Deezer fans, YouTube views, SoundCloud likes.

## Query parameters

- `since` string, date: Inclusive start of the date range in `YYYY-MM-DD` format. Defaults to 180 days before today.
- `until` string, date: Inclusive end of the date range in `YYYY-MM-DD` format. Defaults to today.

## Response `200`

Success

- object
  - `obj` object[], required
    - `id` integer, nullable: Internal stat row ID. `null` for a day only an on-demand refresh has written so far.
    - `value` integer, required: Stat value at this timestamp. Meaning varies by platform: Spotify followers, Deezer fans, YouTube views, SoundCloud likes.
    - `timestp` union, required: Timestamp of the data point.
      - string
      - string, date-time
    - `daily_diff` integer, nullable: Day-over-day change in `value`.
    - `weekly_diff` integer, nullable: Week-over-week change in `value`.
    - `weekly_diff_percent` number, float, nullable: Week-over-week change as a fraction of the prior value.
    - `monthly_diff` integer, nullable: Month-over-month change in `value`.
    - `monthly_diff_percent` number, float, nullable: Month-over-month change as a fraction of the prior value.
    - `interpolated` boolean: Whether `value` was interpolated to fill a gap in source data.
    - `extrapolated` boolean: Whether `value` was extrapolated past the latest source data point.
    - `flags` boolean: Whether the stat row is flagged for review.

---

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