Skip to main content
GET
/
api
/
research
/
tracks
/
{id}
/
measurements
Track measurements
curl --request GET \
  --url https://api.recoupable.com/api/research/tracks/{id}/measurements
{
  "status": "success",
  "id": "USQY51771120",
  "platform": "spotify",
  "metric": "platform_displayed_play_count",
  "series": [
    {
      "date": "2026-06-12",
      "value": 297289495,
      "data_source": "songstats"
    }
  ],
  "aggregate": {
    "kind": "run_rate",
    "window_days": 365,
    "delta": 42000000,
    "run_rate_annualized": 42000000
  }
}

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

Present when aggregate=run_rate.