Listening

Listening stats

GET https://api.rewind.rest/v1/listening/stats

Returns listening statistics. Supports optional date filtering to scope stats to a time period.

Authorization

Authorizationheaderstringrequired

API key. Read keys (rw_live_...) access GET endpoints. Admin keys (rw_admin_...) access all endpoints.

Query Parameters

datequerystring

Single day (YYYY-MM-DD). Overrides from/to.

fromquerystring

Range start, inclusive (ISO 8601)

toquerystring

Range end, inclusive (ISO 8601)

Response

application/json

Listening statistics

total_scrobblesnumberrequired

unique_artistsnumberrequired

unique_albumsnumberrequired

unique_tracksnumberrequired

registered_datestringrequired

years_trackingnumberrequired

scrobbles_per_daynumberrequired

cURL

curl -X GET 'https://api.rewind.rest/v1/listening/stats' \
  -H 'Authorization: Bearer <token>'

200

{
  "total_scrobbles": 0,
  "unique_artists": 0,
  "unique_albums": 0,
  "unique_tracks": 0,
  "registered_date": "string",
  "years_tracking": 0,
  "scrobbles_per_day": 0
}