Top artists

GET https://api.rewind.rest/v1/listening/top/artists

Returns your top artists for a given time period.

Authorization

Authorizationheaderstringrequired

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

Query Parameters

periodqueryenum (string)

Allowed values7day1month3month6month12monthoverall

pagequeryinteger

limitqueryinteger

datequerystring

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

fromquerystring

Range start, inclusive (ISO 8601)

toquerystring

Range end, inclusive (ISO 8601)

include_sparklinesqueryboolean

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.

Authorization

Query Parameters

Response

properties

properties