---
title: "Get Batch Playlist Stream Estimates"
method: POST
path: "/api/track/playlist-stream-estimates"
tags: ["Track"]
---

# Get Batch Playlist Stream Estimates

`POST /api/track/playlist-stream-estimates`

## Request

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

Return per-track availability and playlist stream estimates for a batch of track IDs. Missing tracks are returned with `status: "not_found"` rather than failing the whole request.

## 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.

## Request body

- object
  - `ids` integer[], required: One or more Chartmetric track IDs.

## Response `200`

Success

- object
  - `obj` object[], required
    - `cm_track` integer, required
    - `status` 'available' | 'not_found', required
    - `estimates` object[], required
      - `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)