Listening

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

Authorizationheaderstringrequired

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

Path Parameters

yearpathstringrequired

Query Parameters

monthqueryinteger

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

include_sparklinesqueryboolean

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).

Response

application/json

Year in review data

yearnumberrequired

monthnumber

total_scrobblesnumberrequired

unique_artistsnumberrequired

unique_albumsnumberrequired

unique_tracksnumberrequired

top_artistsarray of objectrequired

properties

top_albumsarray of objectrequired

properties

top_tracksarray of objectrequired

properties

monthlyarray of objectrequired

properties

cURL

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

200

{
  "year": 0,
  "month": 0,
  "total_scrobbles": 0,
  "unique_artists": 0,
  "unique_albums": 0,
  "unique_tracks": 0,
  "top_artists": [
    {
      "id": 0,
      "name": "string",
      "scrobbles": 0,
      "apple_music_url": "string",
      "image": {},
      "sparkline": {
        "granularity": "\u2026",
        "points": "\u2026"
      }
    }
  ],
  "top_albums": [
    {
      "id": 0,
      "name": "string",
      "artist": "string",
      "scrobbles": 0,
      "apple_music_url": "string",
      "image": {},
      "sparkline": {
        "granularity": "\u2026",
        "points": "\u2026"
      }
    }
  ],
  "top_tracks": [
    {
      "id": 0,
      "name": "string",
      "artist": "string",
      "scrobbles": 0,
      "apple_music_url": "string",
      "preview_url": "string",
      "sparkline": {
        "granularity": "\u2026",
        "points": "\u2026"
      }
    }
  ],
  "monthly": [
    {
      "month": "string",
      "scrobbles": 0,
      "unique_artists": 0,
      "unique_albums": 0
    }
  ]
}