Listening

All year summaries

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

Returns one entry per year tracked, with total scrobbles and unique artist, album, and track counts.

Authorization

Authorizationheaderstringrequired

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

Response

application/json

Year summaries, newest first

dataarray of objectrequired

properties

cURL

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

200

{
  "data": [
    {
      "year": 0,
      "total_scrobbles": 0,
      "unique_artists": 0,
      "unique_albums": 0,
      "unique_tracks": 0,
      "top_artist": {
        "id": "\u2026",
        "name": "\u2026"
      }
    }
  ]
}