Skip to main content
GET
Listening stats

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