Skip to main content
GET
Track measurements

Path Parameters

id
string
required

Provider-neutral track id — ISRC or Spotify track id.

Query Parameters

platform
string
default:spotify

Platform to read. Currently spotify.

metric
string
default:platform_displayed_play_count

Metric to read.

from
string<date>

Inclusive start date (ISO) for the series.

to
string<date>

Inclusive end date (ISO) for the series.

granularity
enum<string>
default:daily

Series granularity. daily returns the per-day cumulative series.

Available options:
daily
aggregate
enum<string>

Return a derived aggregate instead of the raw series. run_rate returns the trailing-window annualized run-rate (a projection of the series).

Available options:
run_rate
window
string
default:365d

Trailing window for aggregate=run_rate (e.g. 365d).

Response

The measurement series (or the requested aggregate).

A track's measured series, or — when aggregate is set — the derived projection.

status
string
Example:

"success"

id
string

The provider-neutral track id queried.

Example:

"USQY51771120"

platform
string
Example:

"spotify"

metric
string
Example:

"platform_displayed_play_count"

series
object[]

Present unless aggregate is set.

aggregate
object | null

Present when aggregate=run_rate.