curl --request GET \
--url https://api.rewind.rest/v1/listening/top/tracks \
--header 'Authorization: Bearer <token>'{
"period": "overall",
"artist_id": null,
"data": [
{
"rank": 1,
"id": 595,
"name": "Come as You Are",
"detail": "Nirvana",
"playcount": 101,
"image": null,
"url": "https://www.last.fm/music/Nirvana/_/Come+as+You+Are",
"apple_music_url": "https://music.apple.com/us/album/come-as-you-are/1440783617?i=1440783636&uo=4",
"preview_url": null
},
{
"rank": 2,
"id": 1050,
"name": "bad idea right?",
"detail": "Olivia Rodrigo",
"playcount": 82,
"image": null,
"url": "https://www.last.fm/music/Olivia+Rodrigo/_/bad+idea+right%3F",
"apple_music_url": null,
"preview_url": null
},
{
"rank": 3,
"id": 2001,
"name": "Espresso",
"detail": "Sabrina Carpenter",
"playcount": 68,
"image": null,
"url": "https://www.last.fm/music/Sabrina+Carpenter/_/Espresso",
"apple_music_url": null,
"preview_url": null
}
],
"pagination": {
"page": 1,
"limit": 20,
"total": 13,
"total_pages": 1
}
}Returns top tracks for a given time period. Pass artist_id (or artist_name substring) to filter to a single artist’s catalog — composes with period and the date filters. Pass include_sparklines=true to attach a play-count time series per track (1month/3month/6month/12month/overall).
curl --request GET \
--url https://api.rewind.rest/v1/listening/top/tracks \
--header 'Authorization: Bearer <token>'{
"period": "overall",
"artist_id": null,
"data": [
{
"rank": 1,
"id": 595,
"name": "Come as You Are",
"detail": "Nirvana",
"playcount": 101,
"image": null,
"url": "https://www.last.fm/music/Nirvana/_/Come+as+You+Are",
"apple_music_url": "https://music.apple.com/us/album/come-as-you-are/1440783617?i=1440783636&uo=4",
"preview_url": null
},
{
"rank": 2,
"id": 1050,
"name": "bad idea right?",
"detail": "Olivia Rodrigo",
"playcount": 82,
"image": null,
"url": "https://www.last.fm/music/Olivia+Rodrigo/_/bad+idea+right%3F",
"apple_music_url": null,
"preview_url": null
},
{
"rank": 3,
"id": 2001,
"name": "Espresso",
"detail": "Sabrina Carpenter",
"playcount": 68,
"image": null,
"url": "https://www.last.fm/music/Sabrina+Carpenter/_/Espresso",
"apple_music_url": null,
"preview_url": null
}
],
"pagination": {
"page": 1,
"limit": 20,
"total": 13,
"total_pages": 1
}
}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
Filter top tracks to a single artist's catalog. Stable id from get_artist_details or get_top_artists. Composes with period and date filters.
189
Substring match against lastfm_artists.name. Resolves to the highest-playcount artist. Use only when no artist_id is available; passing both is a 400.
1"olivia rodrigo"