Skip to main content
GET
/
v1
/
listening
/
top
/
albums
Top albums
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.

Authorizations

Authorization
string
header
required

API key. Read keys (rw_live_...) access GET endpoints. Admin keys (rw_admin_...) access all endpoints.

Query Parameters

period
enum<string>
default:7day
Available options:
7day,
1month,
3month,
6month,
12month,
overall
Example:

"7day"

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

1

limit
integer
default:10
Required range: 1 <= x <= 50
Example:

10

date
string

Single day (YYYY-MM-DD). Overrides from/to.

Pattern: ^\d{4}-\d{2}-\d{2}$
Example:

"2025-02-17"

from
string

Range start, inclusive (ISO 8601)

Example:

"2025-02-01T00:00:00Z"

to
string

Range end, inclusive (ISO 8601)

Example:

"2025-02-28T23:59:59Z"

include_sparklines
boolean | null

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.

Example:

false

Response

Top albums list

period
string
required
data
object[]
required
pagination
object
required