Rewind

Listening

Top tracks

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

Returns your top tracks for a given time period, optionally scoped to a single artist.

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.

artist_idqueryinteger

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.

artist_namequerystring

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.

Response

application/json

Top tracks list

periodstringrequired
artist_idnumber
dataarray of objectrequired
paginationobjectrequired