Skip to main content
GET
/
app.rocksky.artist.getArtistListeners
Get artist listeners
curl --request GET \
  --url https://api.rocksky.app/xrpc/app.rocksky.artist.getArtistListeners \
  --header 'Authorization: Bearer <token>'
{
  "listeners": [
    {
      "id": "<string>",
      "did": "<string>",
      "handle": "<string>",
      "displayName": "<string>",
      "avatar": "<string>",
      "mostListenedSong": {
        "uri": "<string>",
        "title": "<string>",
        "playCount": 1
      },
      "totalPlays": 1,
      "rank": 2
    }
  ]
}

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

​
uri
string<at-uri>
required

The URI of the artist to retrieve listeners from

​
offset
integer

Number of items to skip before returning results

​
limit
integer

Maximum number of results to return

Response

OK

​
listeners
object[]