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
}
]
}Returns year-in-review listening data. Optionally pass ?month=N to scope to a single month.
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.
API key. Read keys (rw_live_...) access GET endpoints. Admin keys (rw_admin_...) access all endpoints.
"2024"
Optional month (1-12) to scope results to a single month
1 <= x <= 123
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).
false
Year in review data
Show child attributes
Show child attributes
Show child attributes
Show child attributes