Skip to main content
GET
/
app.rocksky.song.getSongs
Get songs
curl --request GET \
  --url https://api.rocksky.app/xrpc/app.rocksky.song.getSongs \
  --header 'Authorization: Bearer <token>'
{
  "songs": [
    {
      "id": "<string>",
      "title": "<string>",
      "artist": "<string>",
      "albumArtist": "<string>",
      "albumArt": "<string>",
      "uri": "<string>",
      "album": "<string>",
      "duration": 123,
      "trackNumber": 123,
      "discNumber": 123,
      "playCount": 1,
      "uniqueListeners": 1,
      "albumUri": "<string>",
      "artistUri": "<string>",
      "sha256": "<string>",
      "mbid": "<string>",
      "isrc": "<string>",
      "tags": [
        "<string>"
      ],
      "createdAt": "2023-11-07T05:31:56Z"
    }
  ]
}

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

limit
integer

The maximum number of songs to return

Required range: x >= 1
offset
integer

The offset for pagination

Required range: x >= 0
genre
string

The genre to filter artists by

mbid
string

Filter songs by MusicBrainz ID

isrc
string

Filter songs by International Standard Recording Code (ISRC)

spotifyId
string

Filter songs by Spotify track ID (resolved internally to the Spotify track URL)

Response

OK

songs
object[]