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 User's Albums

GET
/xrpc/app.rocksky.actor.getActorAlbums
Get Rocksky catalog information for multiple albums by user's did

Request

Query Params
limit
integer 
optional
Example:
20
offset
integer 
optional
Example:
0
did
string 
required
Example:
tsiry-sandratraina.com

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.actor.getActorAlbums?limit=20&offset=0&did=tsiry-sandratraina.com'

Responses

🟢200OK
application/json
Body
albums
array [object {11}] 
required
id
string 
required
title
string 
required
artist
string 
required
releaseDate
string 
optional
albumArt
string 
required
year
integer 
required
sha256
string 
required
uri
string 
required
artistUri
string 
required
playCount
integer 
required
uniqueListeners
integer 
required
Example
{
    "albums": [
        {
            "id": "rec_cus6ofqojig7sjj88jbg",
            "title": "Sound Of A Woman",
            "artist": "Kiesza",
            "releaseDate": "2014-10-21",
            "albumArt": "https://cdn.rocksky.app/covers/e02bb04c7c33799e8bcf7fb4d3e07335.jpg",
            "year": 2014,
            "sha256": "cb3db2a2bd3e5c31ce0dc9dc391a8af1ac0cba5c4e42793ab5f5a5807959064c",
            "uri": "at://did:plc:7vdlgi2bflelz7mmuxoqjfcr/app.rocksky.album/3liorhbl4dk23",
            "artistUri": "at://did:plc:7vdlgi2bflelz7mmuxoqjfcr/app.rocksky.artist/3liorhapngk23",
            "playCount": 155,
            "uniqueListeners": 1
        },
        {
            "id": "rec_cuh97cr9sf5f7iluqaa0",
            "title": "Random Access Memories",
            "artist": "Daft Punk",
            "releaseDate": "2013-05-20",
            "albumArt": "https://cdn.rocksky.app/covers/179c025878bca2fcff445179e21825bc.jpg",
            "year": 2013,
            "sha256": "6b4c15fb9e701eacc7080c5e997a73d9c44caa6ce62d386731f946d6bb39fecd",
            "uri": "at://did:plc:7vdlgi2bflelz7mmuxoqjfcr/app.rocksky.album/3lhlkzzimck2k",
            "artistUri": "at://did:plc:7vdlgi2bflelz7mmuxoqjfcr/app.rocksky.artist/3lhlkzyo5ms2k",
            "playCount": 137,
            "uniqueListeners": 1
        },
        {
            "id": "rec_cuku8v7c45bvnl7qgv0g",
            "title": "Meteora 20th Anniversary Edition",
            "artist": "Linkin Park",
            "releaseDate": "2023-04-07",
            "albumArt": "https://cdn.rocksky.app/covers/da9e82337eb069388e05b93f89c9c41c.jpg",
            "year": 2023,
            "sha256": "4c522dec5ae20c7a125265b5485c6124850c94cabf43fe489d054f1bf9a187cb",
            "uri": "at://did:plc:7vdlgi2bflelz7mmuxoqjfcr/app.rocksky.album/3lhtdpslp4c2e",
            "artistUri": "at://did:plc:7vdlgi2bflelz7mmuxoqjfcr/app.rocksky.artist/3lht527poys2e",
            "playCount": 132,
            "uniqueListeners": 1
        },
        {
            "id": "rec_cuvct0qb05cnm2frvmb0",
            "title": "LONG.LIVE.A$AP (Deluxe Version)",
            "artist": "A$AP Rocky",
            "releaseDate": "2013-01-11",
            "albumArt": "https://i.scdn.co/image/ab67616d0000b2733265ed162fa2dd5ec6434ee4",
            "year": 2013,
            "sha256": "094e4c69e93fdc77368689508472af9b19426dc68cedea4c7218725ff3bc83e6",
            "uri": "at://did:plc:7vdlgi2bflelz7mmuxoqjfcr/app.rocksky.album/3lj2wxd3dts2l",
            "artistUri": "at://did:plc:7vdlgi2bflelz7mmuxoqjfcr/app.rocksky.artist/3liyor4m2xc2l",
            "playCount": 126,
            "uniqueListeners": 1
        },
        {
            "id": "rec_cuve3f2b05cnm2frvnng",
            "title": "AT.LONG.LAST.A$AP",
            "artist": "A$AP Rocky",
            "releaseDate": "2015-05-26",
            "albumArt": "https://i.scdn.co/image/ab67616d0000b27381a6a2cafab2e7a4066b5eec",
            "year": 2015,
            "sha256": "b7fc33948cfaaf92f1855d2e3315cd6286caac7c7defc58168d3d09ffdd65cde",
            "uri": "at://did:plc:7vdlgi2bflelz7mmuxoqjfcr/app.rocksky.album/3lj33jydamc2l",
            "artistUri": "at://did:plc:7vdlgi2bflelz7mmuxoqjfcr/app.rocksky.artist/3liyor4m2xc2l",
            "playCount": 116,
            "uniqueListeners": 1
        },
        {
            "id": "rec_cuunarqojig7sjj8g910",
            "title": "The Off-Season",
            "artist": "J. Cole",
            "releaseDate": "2021-05-14",
            "albumArt": "https://i.scdn.co/image/ab67616d0000b27310e6745bb2f179dd3616b85f",
            "year": 2021,
            "sha256": "cac6db36e1f8bab6249e7d1806e9ea92591a2affd9c80f8e711412815587c7b1",
            "uri": "at://did:plc:7vdlgi2bflelz7mmuxoqjfcr/app.rocksky.album/3liyeolehos2l",
            "artistUri": "at://did:plc:7vdlgi2bflelz7mmuxoqjfcr/app.rocksky.artist/3liw2eggxws2l",
            "playCount": 105,
            "uniqueListeners": 1
        },
        {
            "id": "rec_cuh8sub9sf5f7iluqa20",
            "title": "Another Friday Night",
            "artist": "Joel Corry",
            "releaseDate": "2023-07-14",
            "albumArt": "https://cdn.rocksky.app/covers/ec9bbc208b04182f315f8137cfb2125b.jpg",
            "year": 2023,
            "sha256": "2c8302d5c3ae60dfa316378e86c144050fc054adbf2849505867f97f4443b8bb",
            "uri": "at://did:plc:7vdlgi2bflelz7mmuxoqjfcr/app.rocksky.album/3lhlp5pldws2k",
            "artistUri": "at://did:plc:7vdlgi2bflelz7mmuxoqjfcr/app.rocksky.artist/3lhlp5opmak2k",
            "playCount": 101,
            "uniqueListeners": 1
        },
        {
            "id": "rec_cuvcegaojig7sjj8k6ng",
            "title": "BOOMIVERSE",
            "artist": "Big Boi",
            "releaseDate": "2017-06-16",
            "albumArt": "https://i.scdn.co/image/ab67616d0000b273b7dd9467fa963431c0e3f411",
            "year": 2017,
            "sha256": "ff32884ce9c3159dfceeeae5e69636487cfc1cbe4d312f40f32d750f0061a21b",
            "uri": "at://did:plc:7vdlgi2bflelz7mmuxoqjfcr/app.rocksky.album/3lj2v7xfcuc2l",
            "artistUri": "at://did:plc:7vdlgi2bflelz7mmuxoqjfcr/app.rocksky.artist/3liz2hvwg222l",
            "playCount": 98,
            "uniqueListeners": 1
        },
        {
            "id": "rec_cuhk8mpo74fi003acgeg",
            "title": "Constellations (Expanded)",
            "artist": "Jazzy",
            "releaseDate": "2023-10-20",
            "albumArt": "https://cdn.rocksky.app/covers/e27039e89dbccf04a6a698cd0b6e160b.jpg",
            "year": 2023,
            "sha256": "819194b44bba691f4efc4463436adc62d32f29f2bfdf968ba008bec4ba2da2f5",
            "uri": "at://did:plc:7vdlgi2bflelz7mmuxoqjfcr/app.rocksky.album/3lhkzzpqwok2v",
            "artistUri": "at://did:plc:7vdlgi2bflelz7mmuxoqjfcr/app.rocksky.artist/3lhkzzooeac2v",
            "playCount": 79,
            "uniqueListeners": 1
        },
        {
            "id": "rec_cut2n6qojig7sjj8aps0",
            "title": "METRO BOOMIN PRESENTS SPIDER-MAN: ACROSS THE SPIDER-VERSE (SOUNDTRACK FROM AND INSPIRED BY THE MOTION PICTURE)",
            "artist": "Metro Boomin",
            "releaseDate": "2023-06-02",
            "albumArt": "https://i.scdn.co/image/ab67616d0000b2736ed9aef791159496b286179f",
            "year": 2023,
            "sha256": "5d232f47252f513d889f4787b8a1869a69ca47fa6d2da2837d7520e056d46c93",
            "uri": "at://did:plc:7vdlgi2bflelz7mmuxoqjfcr/app.rocksky.album/3lis3xvqqak2x",
            "artistUri": "at://did:plc:7vdlgi2bflelz7mmuxoqjfcr/app.rocksky.artist/3lis3xuvi6c2x",
            "playCount": 79,
            "uniqueListeners": 1
        }
    ]
}
Modified at 2025-06-12 08:27:38
Previous
help
Next
Get Album
Built with