Skip to main content
GET
/
app.rocksky.stats.getWrapped
Get a user's year-in-review Wrapped stats
curl --request GET \
  --url https://api.rocksky.app/xrpc/app.rocksky.stats.getWrapped \
  --header 'Authorization: Bearer <token>'
{
  "year": 123,
  "totalScrobbles": 1,
  "totalListeningTimeMinutes": 1,
  "topArtists": [
    {
      "id": "<string>",
      "name": "<string>",
      "picture": "<string>",
      "uri": "<string>",
      "playCount": 1
    }
  ],
  "topTracks": [
    {
      "id": "<string>",
      "title": "<string>",
      "artist": "<string>",
      "albumArt": "<string>",
      "uri": "<string>",
      "artistUri": "<string>",
      "albumUri": "<string>",
      "playCount": 1
    }
  ],
  "topAlbums": [
    {
      "id": "<string>",
      "title": "<string>",
      "artist": "<string>",
      "albumArt": "<string>",
      "uri": "<string>",
      "playCount": 1
    }
  ],
  "topGenres": [
    {
      "genre": "<string>",
      "count": 1
    }
  ],
  "scrobblesPerMonth": [
    {
      "month": 6,
      "count": 1
    }
  ],
  "mostActiveDay": {
    "date": "<string>",
    "count": 1
  },
  "mostActiveHour": 11,
  "newArtistsCount": 1,
  "longestStreak": 1,
  "firstScrobble": {
    "trackTitle": "<string>",
    "artistName": "<string>",
    "timestamp": "2023-11-07T05:31:56Z",
    "trackUri": "<string>"
  },
  "lastScrobble": {
    "trackTitle": "<string>",
    "artistName": "<string>",
    "timestamp": "2023-11-07T05:31:56Z",
    "trackUri": "<string>"
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.rocksky.app/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

did
string<at-identifier>
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

Response

OK

year
integer
totalScrobbles
integer
Required range: x >= 0
totalListeningTimeMinutes
integer
Required range: x >= 0
topArtists
object[]
topTracks
object[]
topAlbums
object[]
topGenres
object[]
scrobblesPerMonth
object[]
mostActiveDay
object
mostActiveHour
integer
Required range: 0 <= x <= 23
newArtistsCount
integer
Required range: x >= 0
longestStreak
integer
Required range: x >= 0
firstScrobble
object
lastScrobble
object