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 Several Albums

GET
/xrpc/app.rocksky.album.getAlbums
Get Rocksky catalog information for multiple albums

Request

Query Params

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.getAlbums?offset=0&limit=20'

Responses

🟢200OK
application/json
Body

Example
{
    "albums": [
        {
            "id": "rec_cvp566q3cr39j8ictpg0",
            "title": "INERTIA",
            "artist": "SawanoHiroyuki[nZk]",
            "releaseDate": "2025-04-06",
            "albumArt": "https://i.scdn.co/image/ab67616d0000b2735345d2453cfdd82b262c6bf6",
            "year": 2025,
            "sha256": "8791516ce5b8f80e9527cc1f8806e8ba58d061abde65be6762b9602f3e0620d5",
            "uri": "at://did:plc:fip3nyk6tjo3senpq4ei2cxw/app.rocksky.album/3lm57ed4bu22o",
            "artistUri": "at://did:plc:fip3nyk6tjo3senpq4ei2cxw/app.rocksky.artist/3lls66qy3i224",
            "playCount": 184,
            "uniqueListeners": 1
        },
        {
            "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_cvp57s2kv5eu8u82r2j0",
            "title": "PARAGON",
            "artist": "Sawano Hiroyuki",
            "releaseDate": "2025-04-06",
            "albumArt": "https://i.scdn.co/image/ab67616d0000b27357a554927924cb4a01bdd54e",
            "year": 2025,
            "sha256": "785e8bc003b758a28821239414b46f3dfa5fee20d33d5bd3e246cc6bcde2c53a",
            "uri": "at://did:plc:fip3nyk6tjo3senpq4ei2cxw/app.rocksky.album/3lm57knnkak2o",
            "artistUri": "at://did:plc:fip3nyk6tjo3senpq4ei2cxw/app.rocksky.artist/3llqs75usr22o",
            "playCount": 141,
            "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": 138,
            "uniqueListeners": 2
        },
        {
            "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": 133,
            "uniqueListeners": 2
        },
        {
            "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_d03p3qo7tclmdnupp77g",
            "title": "KONTINUUM",
            "artist": "SennaRin",
            "releaseDate": "2025-04-13",
            "albumArt": "https://i.scdn.co/image/ab67616d0000b273bc5b7e546b09436bca3c2aef",
            "year": 2025,
            "sha256": "e173b5bdc4402a21028e660c8e95a5c3bf62248c31b9c67ec6a278e3277a3ee4",
            "uri": "at://did:plc:fip3nyk6tjo3senpq4ei2cxw/app.rocksky.album/3lnfq36jgs22p",
            "artistUri": "at://did:plc:fip3nyk6tjo3senpq4ei2cxw/app.rocksky.artist/3lm576ks4nc2o",
            "playCount": 112,
            "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_cuhmqfae5drjqa1aqma0",
            "title": "Hurry Up Tomorrow",
            "artist": "The Weeknd",
            "releaseDate": "2025-01-31",
            "albumArt": "https://cdn.rocksky.app/covers/a4f0a009ce6ecf71949612674aed84dd.jpg",
            "year": 2025,
            "sha256": "9d4ffdfd921d5c7c51f48183b6eaaf14bf8017c25cbbcb050823b305bfd6becd",
            "uri": "at://did:plc:7vdlgi2bflelz7mmuxoqjfcr/app.rocksky.album/3lhlmoc2ji22k",
            "artistUri": "at://did:plc:7vdlgi2bflelz7mmuxoqjfcr/app.rocksky.artist/3lhlaglv5722i",
            "playCount": 88,
            "uniqueListeners": 2
        },
        {
            "id": "rec_cvn8k40jh98g0qpmgpb0",
            "title": "EPIC: The Underworld Saga (Official Concept Album)",
            "artist": "Jorge Rivera-Herrans",
            "releaseDate": "2024-04-26",
            "albumArt": "https://i.scdn.co/image/ab67616d0000b273fba95a78235cb1d98f516b20",
            "year": 2024,
            "sha256": "289d8518e6ce164035e144ec00788401be02d67f0b13c0a84e8ef814ca4bbb80",
            "uri": "at://did:plc:fip3nyk6tjo3senpq4ei2cxw/app.rocksky.album/3llvyd3qbus2q",
            "artistUri": "at://did:plc:fip3nyk6tjo3senpq4ei2cxw/app.rocksky.artist/3llvtwxbd5k2q",
            "playCount": 87,
            "uniqueListeners": 1
        },
        {
            "id": "rec_d018i8ikv5eu8u84bjp0",
            "title": "herdbound",
            "artist": "bit depth",
            "releaseDate": "2024-02-02",
            "albumArt": "https://i.scdn.co/image/ab67616d0000b2738f203786e09c4b63d2a3d786",
            "year": 2024,
            "sha256": "3ec8deb7137191a7e73d696d69ed60429d4dc1fa66713a99d0024a041a1dddf9",
            "uri": "at://did:plc:5amoelshbjx4rmg4g5jpepl7/app.rocksky.album/3ln44sjfmas2s",
            "artistUri": "at://did:plc:5amoelshbjx4rmg4g5jpepl7/app.rocksky.artist/3ln32ffjry22e",
            "playCount": 86,
            "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
        },
        {
            "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_cuur0kqojig7sjj8hv0g",
            "title": "Promise Everything (Deluxe)",
            "artist": "Basement",
            "releaseDate": "2017-03-03",
            "albumArt": "https://i.scdn.co/image/ab67616d0000b273042a795b1fb9bf6efc9d5b21",
            "year": 2017,
            "sha256": "f848aa4064359944a500176137bb009a0d7e7588009bd82cae443cccd1294a87",
            "uri": "at://did:plc:7vdlgi2bflelz7mmuxoqjfcr/app.rocksky.album/3liyspvgxzs2l",
            "artistUri": "at://did:plc:7vdlgi2bflelz7mmuxoqjfcr/app.rocksky.artist/3liysptelz22l",
            "playCount": 78,
            "uniqueListeners": 1
        },
        {
            "id": "rec_cuhgbpj9sf5f7ilv7rvg",
            "title": "Taylor Allderdice",
            "artist": "Wiz Khalifa",
            "releaseDate": "2012-05-14",
            "albumArt": "https://cdn.rocksky.app/covers/392637fac8b22b54e802a163c1ffd94a.jpg",
            "year": 2012,
            "sha256": "d9ec304c176e1bacbc5725dcfe745813a8cb759f558beaf15026f84c92e24f1b",
            "uri": "at://did:plc:7vdlgi2bflelz7mmuxoqjfcr/app.rocksky.album/3lhliuaskuk2i",
            "artistUri": "at://did:plc:7vdlgi2bflelz7mmuxoqjfcr/app.rocksky.artist/3lhlj7tdzds2k",
            "playCount": 76,
            "uniqueListeners": 1
        },
        {
            "id": "rec_cuvffpfu3busimrpb4jg",
            "title": "good kid, m.A.A.d city",
            "artist": "Kendrick Lamar",
            "albumArt": "https://i.scdn.co/image/ab67616d0000b2732cd55246d935a8a77cb4859e",
            "year": 2012,
            "sha256": "c1b31b9e6bb9f10fa98e6be7a1e7c4fedf1ea82b9ec8f6a972171cfdab12d818",
            "uri": "at://did:plc:7vdlgi2bflelz7mmuxoqjfcr/app.rocksky.album/3lj3aszvrs22l",
            "artistUri": "at://did:plc:7vdlgi2bflelz7mmuxoqjfcr/app.rocksky.artist/3lj3anbcfns2l",
            "playCount": 75,
            "uniqueListeners": 2
        },
        {
            "id": "rec_d071uj5qrj66ulek0e80",
            "title": "JEOPARDY",
            "artist": "Sawano Hiroyuki",
            "releaseDate": "2025-04-27",
            "albumArt": "https://cdn.bsky.app/img/feed_thumbnail/plain/did:plc:fip3nyk6tjo3senpq4ei2cxw/bafkreifs5f3anvzn7ljknkihto7o6qzdbgm5m226matjlccxiibujabt2m@jpeg",
            "year": 2025,
            "sha256": "3450b1fbec42a4c40804d741831c8c91cc18928db1b6dea3040cfa947e64ca3c",
            "uri": "at://did:plc:fip3nyk6tjo3senpq4ei2cxw/app.rocksky.album/3lns7yjyse222",
            "artistUri": "at://did:plc:fip3nyk6tjo3senpq4ei2cxw/app.rocksky.artist/3llqs75usr22o",
            "playCount": 74,
            "uniqueListeners": 1
        }
    ]
}
Modified at 2025-06-12 08:33:29
Previous
Get Album
Next
Get User's Artists
Built with