Skip to main content
GET
Top artists

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