Year in review
GET https://api.rewind.rest/v1/listening/year/{year}
Returns year-in-review listening data. Optionally pass ?month=N to scope to a single month.
Authorization
AuthorizationrequiredAPI key. Read keys (rw_live_...) access GET endpoints. Admin keys (rw_admin_...) access all endpoints.
Path Parameters
yearrequiredQuery Parameters
monthOptional month (1-12) to scope results to a single month
include_sparklinesWhen 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).