Skip to main content
GET
/
v1
/
listening
/
stats
Listening stats
curl --request GET \
  --url https://api.rewind.rest/v1/listening/stats \
  --header 'Authorization: Bearer <token>'
{
  "total_scrobbles": 123867,
  "unique_artists": 5278,
  "unique_albums": 11168,
  "unique_tracks": 28405,
  "registered_date": "2012-02-09T16:01:17.000Z",
  "years_tracking": 14,
  "scrobbles_per_day": 24
}

Documentation Index

Fetch the complete documentation index at: https://docs.rewind.rest/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

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

Query Parameters

​
date
string

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

Pattern: ^\d{4}-\d{2}-\d{2}$
Example:

"2025-02-17"

​
from
string

Range start, inclusive (ISO 8601)

Example:

"2025-02-01T00:00:00Z"

​
to
string

Range end, inclusive (ISO 8601)

Example:

"2025-02-28T23:59:59Z"

Response

Listening statistics

​
total_scrobbles
number
required
​
unique_artists
number
required
​
unique_albums
number
required
​
unique_tracks
number
required
​
registered_date
string | null
required
​
years_tracking
number
required
​
scrobbles_per_day
number
required