---
title: "Get Playlist Stream Estimates"
method: GET
path: "/api/track/{id}/playlist-stream-estimates"
tags: ["Track"]
---

# Get Playlist Stream Estimates

`GET /api/track/{id}/playlist-stream-estimates`

## Request

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

Return the latest weekly snapshot for a track when no query params are supplied, one requested snapshot via `date`, or all weekly snapshots in a `since`/`until` range. Each row describes a trailing 28-day estimate as of its snapshot date. Returns 404 when no matching snapshot exists — this table is populated incrementally, so a 404 here does not necessarily mean the track ID is invalid. The message distinguishes the two cases: an unfiltered request (no `date`/`since`/`until`) reports the track has no estimate computed yet at all, while a filtered request reports only that nothing matches the requested date or range (the track may still have estimates outside it).

## Path parameters

- `id` integer, required

## Query parameters

- `date` string, date: Snapshot date in YYYY-MM-DD format. Mutually exclusive with `since`/`until`. Omit all of `date`/`since`/`until` to get the latest available snapshot.
- `since` string, date: Start of the weekly snapshot history range in YYYY-MM-DD format.
- `until` string, date: End of the weekly snapshot history range in YYYY-MM-DD format.

## Response `200`

Success

- object
  - `obj` union, required
    - object
      - `cm_track` integer, required: Chartmetric track ID.
      - `timestp` string, required: Weekly snapshot date in YYYY-MM-DD format.
      - `playlist_stream_pct` number, float, required: Estimated percentage of streams generated by playlists.
      - `playlist_count` integer, required: Number of playlists contributing.
      - `expected_playlist_streams` number, float, required: Estimated streams generated by playlists.
      - `streams_gained_in_period` number, float, required: Spotify streams gained during the trailing 28-day model window.
      - `expected_editorial` number, float, required: Estimated editorial playlist streams.
      - `expected_chart` number, float, required: Estimated chart playlist streams.
      - `expected_user_other` number, float, required: Estimated user and other playlist streams.
    - object[]
      - `cm_track` integer, required: Chartmetric track ID.
      - `timestp` string, required: Weekly snapshot date in YYYY-MM-DD format.
      - `playlist_stream_pct` number, float, required: Estimated percentage of streams generated by playlists.
      - `playlist_count` integer, required: Number of playlists contributing.
      - `expected_playlist_streams` number, float, required: Estimated streams generated by playlists.
      - `streams_gained_in_period` number, float, required: Spotify streams gained during the trailing 28-day model window.
      - `expected_editorial` number, float, required: Estimated editorial playlist streams.
      - `expected_chart` number, float, required: Estimated chart playlist streams.
      - `expected_user_other` number, float, required: Estimated user and other playlist streams.

---

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