Skip to main content
GET
/
v1
/
listening
/
artists
Browse artists
curl --request GET \
  --url https://api.rewind.rest/v1/listening/artists \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "id": 130,
      "name": "Beastie Boys",
      "playcount": 4011,
      "genre": "Hip-Hop",
      "url": "https://www.last.fm/music/Beastie+Boys",
      "apple_music_url": null,
      "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"
      }
    },
    {
      "id": 189,
      "name": "Nirvana",
      "playcount": 2179,
      "genre": "Grunge",
      "url": "https://www.last.fm/music/Nirvana",
      "apple_music_url": "https://music.apple.com/us/artist/nirvana/112018?uo=4",
      "image": null
    },
    {
      "id": 92,
      "name": "Taylor Swift",
      "playcount": 2164,
      "genre": "Country",
      "url": "https://www.last.fm/music/Taylor+Swift",
      "apple_music_url": "https://music.apple.com/us/artist/taylor-swift/159260351?uo=4",
      "image": null
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 5278,
    "total_pages": 264
  }
}

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.

Query Parameters

​
page
integer
default:1
Required range: x >= 1
Example:

1

​
limit
integer
default:20
Required range: 1 <= x <= 100
Example:

20

​
sort
enum<string>
default:playcount
Available options:
playcount,
name
Example:

"playcount"

​
order
enum<string>
default:desc
Available options:
asc,
desc
Example:

"desc"

​
search
string
Example:

"Radiohead"

Response

Artist list

​
data
object[]
required
​
pagination
object
required