Rocksky
  1. albums
Rocksky
  • Overview
  • Introduction
  • FAQ
  • How-Tos
    • Migrating to Rocksky Scrobble API
    • Migrating from ListenBrainz to Rocksky
    • How to Use Rocksky with Jellyfin
    • How to Use Rocksky with Navidrome
    • How to Use Rocksky with Pano Scrobbler on Android
    • How to Use Rocksky with Kodi
    • Use Rocksky with Claude Desktop
  • CLI
    • Overview
    • Commands
      • login
      • mcp
      • whoami
      • nowplaying
      • scrobbles
      • search
      • stats
      • artists
      • albums
      • tracks
      • scrobble
      • create apikey
      • help
  • API Reference
    • albums
      • Get User's Albums
        GET
      • Get Album
        GET
      • Get Several Albums
        GET
    • artists
      • Get User's Artists
      • Get Artist
      • Get Several Artists
    • charts
      • Get Scrobbles Per Day
    • playlists
      • Get User's Playlists
      • Get Playlist
    • scrobbles
      • Get Scrobbles
      • Get User's Scrobbles
    • users
      • Find User Profile
    • tracks
      • Get User's Tracks
      • Get Track
      • Get Several Tracks
    • search
      • Search for Item
    • likes
      • Get User's Liked Songs
  1. albums

Get Album

GET
/xrpc/app.rocksky.album.getAlbum
Get Rocksky catalog information for a single album.

Request

Query Params
uri
string 
required
Example:
at://did:plc:7vdlgi2bflelz7mmuxoqjfcr/app.rocksky.album/3lhtdpslp4c2e

Request samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://api.rocksky.app/xrpc/app.rocksky.album.getAlbum?uri=at://did:plc:7vdlgi2bflelz7mmuxoqjfcr/app.rocksky.album/3lhtdpslp4c2e'

Responses

🟢200OK
application/json
Body
id
string 
required
title
string 
required
artist
string 
required
releaseDate
string 
required
year
integer 
required
albumArt
string 
required
uri
string 
required
artistUri
string 
required
appleMusicLink
null 
required
spotifyLink
null 
required
tidalLink
null 
required
youtubeLink
null 
required
sha256
string 
required
createdAt
string 
required
tracks
array [object {24}] 
required
id
string 
required
title
string 
required
artist
string 
required
albumArtist
string 
required
albumArt
string 
required
album
string 
required
trackNumber
integer 
required
duration
integer 
required
mbId
null 
required
youtubeLink
null 
required
spotifyLink
string  | null 
required
appleMusicLink
null 
required
tidalLink
null 
required
sha256
string 
required
discNumber
integer 
required
composer
string  | null 
required
genre
null 
required
label
string  | null 
required
copyrightMessage
string  | null 
required
uri
string  | null 
required
albumUri
string  | null 
required
artistUri
string 
required
createdAt
string 
required
updatedAt
string 
required
playCount
integer 
required
uniqueListeners
integer 
required
Example
{
    "id": "rec_cuku8v7c45bvnl7qgv0g",
    "title": "Meteora 20th Anniversary Edition",
    "artist": "Linkin Park",
    "releaseDate": "2023-04-07T00:00:00.000Z",
    "year": 2023,
    "albumArt": "https://cdn.rocksky.app/covers/da9e82337eb069388e05b93f89c9c41c.jpg",
    "uri": "at://did:plc:7vdlgi2bflelz7mmuxoqjfcr/app.rocksky.album/3lhtdpslp4c2e",
    "artistUri": "at://did:plc:7vdlgi2bflelz7mmuxoqjfcr/app.rocksky.artist/3lht527poys2e",
    "appleMusicLink": null,
    "spotifyLink": null,
    "tidalLink": null,
    "youtubeLink": null,
    "sha256": "4c522dec5ae20c7a125265b5485c6124850c94cabf43fe489d054f1bf9a187cb",
    "createdAt": "2025-02-10T11:35:24.738Z",
    "tracks": [
        {
            "id": "rec_d00ent0jh98g0qpnj2d0",
            "title": "Foreword",
            "artist": "Linkin Park",
            "albumArtist": "Linkin Park",
            "albumArt": "https://i.scdn.co/image/ab67616d0000b273ca2e09fd52e6330146ea9550",
            "album": "Meteora 20th Anniversary Edition",
            "trackNumber": 1,
            "duration": 13386,
            "mbId": null,
            "youtubeLink": null,
            "spotifyLink": "https://open.spotify.com/track/1or6RDFkPMi3u4KM2LUBr3",
            "appleMusicLink": null,
            "tidalLink": null,
            "sha256": "b2203ecbd2aff57940cab5ee19e78a006c34cfe22cc3d08e2e1b7fd32c8cc55e",
            "discNumber": 1,
            "composer": null,
            "genre": null,
            "label": "Warner Records",
            "copyrightMessage": null,
            "uri": "at://did:plc:sjsifypmw7rafiie4x4qltrd/app.rocksky.song/3lmz2c6nrxs2r",
            "albumUri": null,
            "artistUri": "at://did:plc:7vdlgi2bflelz7mmuxoqjfcr/app.rocksky.artist/3lht527poys2e",
            "createdAt": "2025-04-17T11:54:28.300Z",
            "updatedAt": "2025-05-25T17:11:12.666Z"
        },
        {
            "id": "rec_cuku9abm47upkc5jjuig",
            "title": "Meteora - Don't Stay",
            "artist": "Linkin Park",
            "albumArtist": "Linkin Park",
            "albumArt": "https://cdn.rocksky.app/covers/da9e82337eb069388e05b93f89c9c41c.jpg",
            "album": "Meteora 20th Anniversary Edition",
            "trackNumber": 2,
            "duration": 188159,
            "mbId": null,
            "youtubeLink": null,
            "spotifyLink": null,
            "appleMusicLink": null,
            "tidalLink": null,
            "sha256": "b90d4710a2f3fbc37318d297a4cf58191c6697362f03d975423b55f984ebe930",
            "discNumber": 1,
            "composer": "",
            "genre": null,
            "label": null,
            "copyrightMessage": "℗ 2003 Warner Records Inc.",
            "uri": "at://did:plc:7vdlgi2bflelz7mmuxoqjfcr/app.rocksky.song/3lhtdumlqes2e",
            "albumUri": "at://did:plc:7vdlgi2bflelz7mmuxoqjfcr/app.rocksky.album/3lhtdpslp4c2e",
            "artistUri": "at://did:plc:7vdlgi2bflelz7mmuxoqjfcr/app.rocksky.artist/3lht527poys2e",
            "createdAt": "2025-02-10T11:36:09.888Z",
            "updatedAt": "2025-05-12T14:21:59.246Z"
        },
        {
            "id": "rec_cul62ip8pmj2vqvcrl2g",
            "title": "Meteora - Somewhere I Belong",
            "artist": "Linkin Park",
            "albumArtist": "Linkin Park",
            "albumArt": "https://cdn.rocksky.app/covers/da9e82337eb069388e05b93f89c9c41c.jpg",
            "album": "Meteora 20th Anniversary Edition",
            "trackNumber": 3,
            "duration": 214120,
            "mbId": null,
            "youtubeLink": null,
            "spotifyLink": null,
            "appleMusicLink": null,
            "tidalLink": null,
            "sha256": "2ead72e8238dd3b0e15cbda214f1b6a0ea8ed81756087aee344217b774873dc0",
            "discNumber": 1,
            "composer": "",
            "genre": null,
            "label": null,
            "copyrightMessage": "℗ 2003 Warner Records Inc.",
            "uri": null,
            "albumUri": null,
            "artistUri": "at://did:plc:7vdlgi2bflelz7mmuxoqjfcr/app.rocksky.artist/3lht527poys2e",
            "createdAt": "2025-02-10T20:27:55.704Z",
            "updatedAt": "2025-05-25T17:11:12.666Z"
        },
        {
            "id": "rec_cuku9bvc45bvnl7qgv70",
            "title": "Meteora - Lying from You",
            "artist": "Linkin Park",
            "albumArtist": "Linkin Park",
            "albumArt": "https://cdn.rocksky.app/covers/da9e82337eb069388e05b93f89c9c41c.jpg",
            "album": "Meteora 20th Anniversary Edition",
            "trackNumber": 4,
            "duration": 175241,
            "mbId": null,
            "youtubeLink": null,
            "spotifyLink": null,
            "appleMusicLink": null,
            "tidalLink": null,
            "sha256": "edeacc43433cec265f9d6a30a8e45451acc62d54fe23fdc327da8bcb8dcd7013",
            "discNumber": 1,
            "composer": "",
            "genre": null,
            "label": null,
            "copyrightMessage": "℗ 2003 Warner Records Inc.",
Modified at 2025-06-12 08:31:27
Previous
Get User's Albums
Next
Get Several Albums
Built with