Skip to main content
GET
/
v1
/
listening
/
year
/
{year}
Year in review
curl --request GET \
  --url https://api.rewind.rest/v1/listening/year/{year} \
  --header 'Authorization: Bearer <token>'
{
  "year": 2025,
  "total_scrobbles": 8500,
  "unique_artists": 420,
  "unique_albums": 890,
  "unique_tracks": 3200,
  "top_artists": [
    {
      "id": 92,
      "name": "Taylor Swift",
      "scrobbles": 350,
      "apple_music_url": "https://music.apple.com/us/artist/taylor-swift/159260351?uo=4",
      "image": null
    },
    {
      "id": 189,
      "name": "Nirvana",
      "scrobbles": 280,
      "apple_music_url": "https://music.apple.com/us/artist/nirvana/112018?uo=4",
      "image": null
    }
  ],
  "top_albums": [
    {
      "id": 20,
      "name": "GUTS",
      "artist": "Olivia Rodrigo",
      "scrobbles": 120,
      "apple_music_url": null,
      "image": null
    },
    {
      "id": 300,
      "name": "MTV Unplugged in New York",
      "artist": "Nirvana",
      "scrobbles": 95,
      "apple_music_url": null,
      "image": null
    }
  ],
  "top_tracks": [
    {
      "id": 2001,
      "name": "Espresso",
      "artist": "Sabrina Carpenter",
      "scrobbles": 68,
      "apple_music_url": null,
      "preview_url": null
    },
    {
      "id": 1001,
      "name": "bad idea right?",
      "artist": "Olivia Rodrigo",
      "scrobbles": 55,
      "apple_music_url": null,
      "preview_url": null
    }
  ],
  "monthly": [
    {
      "month": "2025-01",
      "scrobbles": 720,
      "unique_artists": 85,
      "unique_albums": 140
    },
    {
      "month": "2025-02",
      "scrobbles": 680,
      "unique_artists": 78,
      "unique_albums": 125
    }
  ]
}

Documentation Index

Fetch the complete documentation index at: https://docs.rewind.rest/llms.txt

Use this file to discover all available pages before exploring further.

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