curl --request GET \
--url https://api.rewind.rest/v1/listening/top/albums \
--header 'Authorization: Bearer <token>'{
"period": "overall",
"data": [
{
"rank": 1,
"id": 300,
"name": "MTV Unplugged in New York",
"detail": "Nirvana",
"playcount": 428,
"image": {
"url": "https://cdn.rewind.rest/listening/albums/300/original.jpg?width=300&height=300&fit=cover&format=auto&quality=85&v=1",
"thumbhash": "HBkKHQi694WIeIiAh3Z3d2eAd4B3",
"dominant_color": "#5c4a6d",
"accent_color": "#c4a8d4"
},
"url": "https://www.last.fm/music/Nirvana/MTV+Unplugged+in+New+York",
"apple_music_url": null
},
{
"rank": 2,
"id": 500,
"name": "Hot Sauce Committee Part Two",
"detail": "Beastie Boys",
"playcount": 534,
"image": null,
"url": "https://www.last.fm/music/Beastie+Boys/Hot+Sauce+Committee+Part+Two",
"apple_music_url": null
},
{
"rank": 3,
"id": 20,
"name": "GUTS",
"detail": "Olivia Rodrigo",
"playcount": 32,
"image": null,
"url": "https://www.last.fm/music/Olivia+Rodrigo/GUTS",
"apple_music_url": null
}
],
"pagination": {
"page": 1,
"limit": 20,
"total": 29,
"total_pages": 2
}
}Returns top albums for a given time period. Pass include_sparklines=true to attach a play-count time series per album (1month/3month/6month/12month/overall).
curl --request GET \
--url https://api.rewind.rest/v1/listening/top/albums \
--header 'Authorization: Bearer <token>'{
"period": "overall",
"data": [
{
"rank": 1,
"id": 300,
"name": "MTV Unplugged in New York",
"detail": "Nirvana",
"playcount": 428,
"image": {
"url": "https://cdn.rewind.rest/listening/albums/300/original.jpg?width=300&height=300&fit=cover&format=auto&quality=85&v=1",
"thumbhash": "HBkKHQi694WIeIiAh3Z3d2eAd4B3",
"dominant_color": "#5c4a6d",
"accent_color": "#c4a8d4"
},
"url": "https://www.last.fm/music/Nirvana/MTV+Unplugged+in+New+York",
"apple_music_url": null
},
{
"rank": 2,
"id": 500,
"name": "Hot Sauce Committee Part Two",
"detail": "Beastie Boys",
"playcount": 534,
"image": null,
"url": "https://www.last.fm/music/Beastie+Boys/Hot+Sauce+Committee+Part+Two",
"apple_music_url": null
},
{
"rank": 3,
"id": 20,
"name": "GUTS",
"detail": "Olivia Rodrigo",
"playcount": 32,
"image": null,
"url": "https://www.last.fm/music/Olivia+Rodrigo/GUTS",
"apple_music_url": null
}
],
"pagination": {
"page": 1,
"limit": 20,
"total": 29,
"total_pages": 2
}
}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.
7day, 1month, 3month, 6month, 12month, overall "7day"
x >= 11
1 <= x <= 5010
Single day (YYYY-MM-DD). Overrides from/to.
^\d{4}-\d{2}-\d{2}$"2025-02-17"
Range start, inclusive (ISO 8601)
"2025-02-01T00:00:00Z"
Range end, inclusive (ISO 8601)
"2025-02-28T23:59:59Z"
When true, attach a sparkline object (granularity + zero-filled points) to each item. On rolling-period endpoints, supported for period in {1month, 3month, 6month, 12month, overall}. overall returns yearly buckets covering the artist/album/track lifetime; 7day is unsupported and the field is omitted.
false