Skip to main content
GET
Top tracks

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