Skip to main content
GET
Get a user's Wrapped stats for a year or a recent rolling window

Query Parameters

did
string
required

The DID or handle of the user

year
integer

The year to get wrapped stats for (defaults to current year)

Required range: x >= 2000
period
string

The window to compute stats over: a calendar year (see year), or a rolling window ending now. Defaults to year.

Response

Success

year
integer

The year of the wrapped stats.

period
string

The window the stats cover.

startDate
string<date-time>

Inclusive start of the window.

endDate
string<date-time>

Exclusive end of the window.

totalScrobbles
integer

Total scrobbles in the year.

Required range: x >= 0
totalListeningTimeMinutes
integer

Total listening time in minutes.

Required range: x >= 0
topArtists
object[]

Top 5 artists by play count.

topTracks
object[]

Top 5 tracks by play count.

topAlbums
object[]

Top 6 albums by play count.

topGenres
object[]

Top genres by play count.

scrobblesPerMonth
object[]

Scrobble counts per month.

scrobblesPerDay
object[]

Scrobble counts per day (UTC), only days with plays.

mostActiveDay
object

The most active day of the year.

mostActiveHour
integer

The most active hour of the day (0-23).

Required range: 0 <= x <= 23
newArtistsCount
integer

Number of artists heard for the first time this year.

Required range: x >= 0
longestStreak
integer

Longest consecutive days streak.

Required range: x >= 0
firstScrobble
object

The first scrobble of the year.

lastScrobble
object

The last scrobble of the year.