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

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 artists list

period
string
required
data
object[]
required
pagination
object
required