curl --request GET \
--url https://api.rewind.rest/v1/listening/top/artists \
--header 'Authorization: Bearer <token>'{
"period": "12month",
"data": [
{
"rank": 1,
"id": 130,
"name": "Beastie Boys",
"detail": "",
"playcount": 4011,
"genre": "Hip-Hop",
"image": {
"url": "https://cdn.rewind.rest/listening/artists/130/original.jpg?width=300&height=300&fit=cover&format=auto&quality=85&v=1",
"thumbhash": "GggGBwDN+CSBp7VXcmVmlyZ2BgAAAAAA",
"dominant_color": "#191919",
"accent_color": "#7e7e7e"
},
"url": "https://www.last.fm/music/Beastie+Boys",
"apple_music_url": null,
"sparkline": {
"granularity": "week",
"points": [
3,
5,
12,
8,
4,
0,
0,
6,
9,
11,
14,
7,
5,
8,
12,
18,
22,
19,
11,
6,
4,
8,
13,
17,
21,
16,
9,
5,
3,
7,
12,
18,
24,
19,
14,
8,
5,
9,
13,
17,
22,
28,
25,
18,
12,
7,
4,
9,
14,
19,
23,
26
]
}
},
{
"rank": 2,
"id": 189,
"name": "Nirvana",
"detail": "",
"playcount": 2179,
"genre": "Grunge",
"image": null,
"url": "https://www.last.fm/music/Nirvana",
"apple_music_url": "https://music.apple.com/us/artist/nirvana/112018?uo=4"
},
{
"rank": 3,
"id": 92,
"name": "Taylor Swift",
"detail": "",
"playcount": 2164,
"genre": "Country",
"image": null,
"url": "https://www.last.fm/music/Taylor+Swift",
"apple_music_url": "https://music.apple.com/us/artist/taylor-swift/159260351?uo=4"
}
],
"pagination": {
"page": 1,
"limit": 20,
"total": 29,
"total_pages": 2
}
}Returns top artists for a given time period. Pass include_sparklines=true to attach a play-count time series per artist. Rolling periods (1month/3month/6month/12month) return daily or weekly buckets; overall returns yearly buckets covering the artist’s lifetime; 7day is unsupported and the field is omitted.
curl --request GET \
--url https://api.rewind.rest/v1/listening/top/artists \
--header 'Authorization: Bearer <token>'{
"period": "12month",
"data": [
{
"rank": 1,
"id": 130,
"name": "Beastie Boys",
"detail": "",
"playcount": 4011,
"genre": "Hip-Hop",
"image": {
"url": "https://cdn.rewind.rest/listening/artists/130/original.jpg?width=300&height=300&fit=cover&format=auto&quality=85&v=1",
"thumbhash": "GggGBwDN+CSBp7VXcmVmlyZ2BgAAAAAA",
"dominant_color": "#191919",
"accent_color": "#7e7e7e"
},
"url": "https://www.last.fm/music/Beastie+Boys",
"apple_music_url": null,
"sparkline": {
"granularity": "week",
"points": [
3,
5,
12,
8,
4,
0,
0,
6,
9,
11,
14,
7,
5,
8,
12,
18,
22,
19,
11,
6,
4,
8,
13,
17,
21,
16,
9,
5,
3,
7,
12,
18,
24,
19,
14,
8,
5,
9,
13,
17,
22,
28,
25,
18,
12,
7,
4,
9,
14,
19,
23,
26
]
}
},
{
"rank": 2,
"id": 189,
"name": "Nirvana",
"detail": "",
"playcount": 2179,
"genre": "Grunge",
"image": null,
"url": "https://www.last.fm/music/Nirvana",
"apple_music_url": "https://music.apple.com/us/artist/nirvana/112018?uo=4"
},
{
"rank": 3,
"id": 92,
"name": "Taylor Swift",
"detail": "",
"playcount": 2164,
"genre": "Country",
"image": null,
"url": "https://www.last.fm/music/Taylor+Swift",
"apple_music_url": "https://music.apple.com/us/artist/taylor-swift/159260351?uo=4"
}
],
"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