Skip to main content
GET
Year in review

Authorizations

Authorization
string
header
required

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

Path Parameters

year
string
required
Example:

"2024"

Query Parameters

month
integer

Optional month (1-12) to scope results to a single month

Required range: 1 <= x <= 12
Example:

3

include_sparklines
boolean | null

When true, attach a sparkline object to each item in top_artists, top_albums, and top_tracks. Without month, returns 12 monthly buckets for the year. With month, returns daily buckets within that month (28-31 points).

Example:

false

Response

Year in review data

year
number
required
total_scrobbles
number
required
unique_artists
number
required
unique_albums
number
required
unique_tracks
number
required
top_artists
object[]
required
top_albums
object[]
required
top_tracks
object[]
required
monthly
object[]
required
month
number