Skip to main content
GET
/
v1
/
listening
/
albums
Browse albums
curl --request GET \
  --url https://api.rewind.rest/v1/listening/albums \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "id": 300,
      "name": "Nevermind",
      "artist": {
        "id": 189,
        "name": "Nirvana"
      },
      "playcount": 333,
      "url": "https://www.last.fm/music/Nirvana/Nevermind",
      "apple_music_url": null,
      "image": null
    },
    {
      "id": 20,
      "name": "GUTS",
      "artist": {
        "id": 37,
        "name": "Olivia Rodrigo"
      },
      "playcount": 32,
      "url": "https://www.last.fm/music/Olivia+Rodrigo/GUTS",
      "apple_music_url": null,
      "image": null
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 11168,
    "total_pages": 559
  }
}

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,
recent
Example:

"playcount"

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

"desc"

​
artist
string
Example:

"Radiohead"

​
search
string
Example:

"OK Computer"

Response

Album list

​
data
object[]
required
​
pagination
object
required