Skip to main content
GET
/
v1
/
listening
/
top
/
tracks
Top tracks
curl --request GET \
  --url https://api.rewind.rest/v1/listening/top/tracks \
  --header 'Authorization: Bearer <token>'
{
  "period": "overall",
  "artist_id": null,
  "data": [
    {
      "rank": 1,
      "id": 595,
      "name": "Come as You Are",
      "detail": "Nirvana",
      "playcount": 101,
      "image": null,
      "url": "https://www.last.fm/music/Nirvana/_/Come+as+You+Are",
      "apple_music_url": "https://music.apple.com/us/album/come-as-you-are/1440783617?i=1440783636&uo=4",
      "preview_url": null
    },
    {
      "rank": 2,
      "id": 1050,
      "name": "bad idea right?",
      "detail": "Olivia Rodrigo",
      "playcount": 82,
      "image": null,
      "url": "https://www.last.fm/music/Olivia+Rodrigo/_/bad+idea+right%3F",
      "apple_music_url": null,
      "preview_url": null
    },
    {
      "rank": 3,
      "id": 2001,
      "name": "Espresso",
      "detail": "Sabrina Carpenter",
      "playcount": 68,
      "image": null,
      "url": "https://www.last.fm/music/Sabrina+Carpenter/_/Espresso",
      "apple_music_url": null,
      "preview_url": null
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 13,
    "total_pages": 1
  }
}

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

​
artist_id
integer

Filter top tracks to a single artist's catalog. Stable id from get_artist_details or get_top_artists. Composes with period and date filters.

Example:

189

​
artist_name
string

Substring match against lastfm_artists.name. Resolves to the highest-playcount artist. Use only when no artist_id is available; passing both is a 400.

Minimum string length: 1
Example:

"olivia rodrigo"

Response

Top tracks list

​
period
string
required
​
data
object[]
required
​
pagination
object
required
​
artist_id
number | null