Rocksky
  1. albums
Rocksky
  • Overview
  • Introduction
  • FAQ
  • How-Tos
    • Migrating to Rocksky Scrobble API
    • 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
      • Save 'Now Playing' Song
      • Get 'Now Playing' Song
    • 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
/albums
Get Rocksky catalog information for multiple albums

Request

Query Params
offset
integer 
required
Example:
0
size
integer 
required
Example:
20

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/albums?offset=0&size=20'

Responses

🟢200OK
application/json
Body
array of:
id
string 
required
title
string 
required
artist
string 
required
release_date
string 
required
album_art
string 
required
year
integer 
required
sha256
string 
required
uri
string 
required
artist_uri
string 
required
play_count
integer 
required
unique_listeners
integer 
required
Example
[
  {
    "id": "rec_cuh97cr9sf5f7iluqaa0",
    "title": "Random Access Memories",
    "artist": "Daft Punk",
    "release_date": "2013-05-20",
    "album_art": "https://cdn.rocksky.app/covers/179c025878bca2fcff445179e21825bc.jpg",
    "year": 2013,
    "sha256": "6b4c15fb9e701eacc7080c5e997a73d9c44caa6ce62d386731f946d6bb39fecd",
    "uri": "at://did:plc:7vdlgi2bflelz7mmuxoqjfcr/app.rocksky.album/3lhlkzzimck2k",
    "artist_uri": "at://did:plc:7vdlgi2bflelz7mmuxoqjfcr/app.rocksky.artist/3lhlkzyo5ms2k",
    "play_count": 75,
    "unique_listeners": 1
  },
  {
    "id": "rec_cuhgbpj9sf5f7ilv7rvg",
    "title": "Taylor Allderdice",
    "artist": "Wiz Khalifa",
    "release_date": "2012-05-14",
    "album_art": "https://cdn.rocksky.app/covers/392637fac8b22b54e802a163c1ffd94a.jpg",
    "year": 2012,
    "sha256": "d9ec304c176e1bacbc5725dcfe745813a8cb759f558beaf15026f84c92e24f1b",
    "uri": "at://did:plc:7vdlgi2bflelz7mmuxoqjfcr/app.rocksky.album/3lhliuaskuk2i",
    "artist_uri": "at://did:plc:7vdlgi2bflelz7mmuxoqjfcr/app.rocksky.artist/3lhlj7tdzds2k",
    "play_count": 48,
    "unique_listeners": 1
  },
  {
    "id": "rec_cuhh4dgn9ptgp5r703r0",
    "title": "New Eyes",
    "artist": "Clean Bandit",
    "release_date": "2014-06-02",
    "album_art": "https://cdn.rocksky.app/covers/d97654a1b35eab7470ddea4996941ec8.jpg",
    "year": 2014,
    "sha256": "b3d118cf21a84ad97835fa5a26cf062a157e8702ba033c6b01fd763a10e5e69b",
    "uri": "at://did:plc:7vdlgi2bflelz7mmuxoqjfcr/app.rocksky.album/3lhl4au2yxs2i",
    "artist_uri": "at://did:plc:7vdlgi2bflelz7mmuxoqjfcr/app.rocksky.artist/3lhl4atdaa22i",
    "play_count": 45,
    "unique_listeners": 1
  },
  {
    "id": "rec_cuh8sub9sf5f7iluqa20",
    "title": "Another Friday Night",
    "artist": "Joel Corry",
    "release_date": "2023-07-14",
    "album_art": "https://cdn.rocksky.app/covers/ec9bbc208b04182f315f8137cfb2125b.jpg",
    "year": 2023,
    "sha256": "2c8302d5c3ae60dfa316378e86c144050fc054adbf2849505867f97f4443b8bb",
    "uri": "at://did:plc:7vdlgi2bflelz7mmuxoqjfcr/app.rocksky.album/3lhlp5pldws2k",
    "artist_uri": "at://did:plc:7vdlgi2bflelz7mmuxoqjfcr/app.rocksky.artist/3lhlp5opmak2k",
    "play_count": 44,
    "unique_listeners": 1
  },
  {
    "id": "rec_cuku8v7c45bvnl7qgv0g",
    "title": "Meteora 20th Anniversary Edition",
    "artist": "Linkin Park",
    "release_date": "2023-04-07",
    "album_art": "https://cdn.rocksky.app/covers/da9e82337eb069388e05b93f89c9c41c.jpg",
    "year": 2023,
    "sha256": "4c522dec5ae20c7a125265b5485c6124850c94cabf43fe489d054f1bf9a187cb",
    "uri": "at://did:plc:7vdlgi2bflelz7mmuxoqjfcr/app.rocksky.album/3lhtdpslp4c2e",
    "artist_uri": "at://did:plc:7vdlgi2bflelz7mmuxoqjfcr/app.rocksky.artist/3lht527poys2e",
    "play_count": 43,
    "unique_listeners": 1
  },
  {
    "id": "rec_cuhnrp67vkdf9dh0phng",
    "title": "F*CK LOVE 3+: OVER YOU",
    "artist": "The Kid LAROI",
    "release_date": "2020-07-24",
    "album_art": "https://cdn.rocksky.app/covers/4e85c8ccf0e0da5d57dffe3765b05f6d.jpg",
    "year": 2020,
    "sha256": "7af3b31642e3586441d832fcbf8f733a9124d8838c2f774e48354c6681dca4ef",
    "uri": "at://did:plc:7vdlgi2bflelz7mmuxoqjfcr/app.rocksky.album/3lhljza2v322k",
    "artist_uri": "at://did:plc:7vdlgi2bflelz7mmuxoqjfcr/app.rocksky.artist/3lhl4s5t7ts2i",
    "play_count": 42,
    "unique_listeners": 1
  },
  {
    "id": "rec_cuhmbo1o74fi003aefj0",
    "title": "THE FIRST TIME (DELUXE VERSION)",
    "artist": "The Kid LAROI",
    "release_date": "2023-11-10",
    "album_art": "https://cdn.rocksky.app/covers/cf8b6443a5500523f1fc8b2c59baae92.jpg",
    "year": 2023,
    "sha256": "8ffcc0bde6924f0b6d79e40fdfdcea5b01ed8502cf0ec7e15c5d7ad6fa50fcdd",
    "uri": "at://did:plc:7vdlgi2bflelz7mmuxoqjfcr/app.rocksky.album/3lhl2urqtwk2i",
    "artist_uri": "at://did:plc:7vdlgi2bflelz7mmuxoqjfcr/app.rocksky.artist/3lhl4s5t7ts2i",
    "play_count": 41,
    "unique_listeners": 1
  },
  {
    "id": "rec_cuhmqfae5drjqa1aqma0",
    "title": "Hurry Up Tomorrow",
    "artist": "The Weeknd",
    "release_date": "2025-01-31",
    "album_art": "https://cdn.rocksky.app/covers/a4f0a009ce6ecf71949612674aed84dd.jpg",
    "year": 2025,
    "sha256": "9d4ffdfd921d5c7c51f48183b6eaaf14bf8017c25cbbcb050823b305bfd6becd",
    "uri": "at://did:plc:7vdlgi2bflelz7mmuxoqjfcr/app.rocksky.album/3lhlmoc2ji22k",
    "artist_uri": "at://did:plc:7vdlgi2bflelz7mmuxoqjfcr/app.rocksky.artist/3lhlaglv5722i",
    "play_count": 39,
    "unique_listeners": 1
  },
  {
    "id": "rec_cuhk8mpo74fi003acgeg",
    "title": "Constellations (Expanded)",
    "artist": "Jazzy",
    "release_date": "2023-10-20",
    "album_art": "https://cdn.rocksky.app/covers/e27039e89dbccf04a6a698cd0b6e160b.jpg",
    "year": 2023,
    "sha256": "819194b44bba691f4efc4463436adc62d32f29f2bfdf968ba008bec4ba2da2f5",
    "uri": "at://did:plc:7vdlgi2bflelz7mmuxoqjfcr/app.rocksky.album/3lhkzzpqwok2v",
    "artist_uri": "at://did:plc:7vdlgi2bflelz7mmuxoqjfcr/app.rocksky.artist/3lhkzzooeac2v",
    "play_count": 37,
    "unique_listeners": 1
  },
  {
    "id": "rec_cumbd3232d0ktpi4jpcg",
    "title": "Crenshaw",
    "artist": "Nipsey Hussle",
    "release_date": "2013-10-22",
    "album_art": "https://cdn.rocksky.app/covers/ea762d636bc28f0e69374ba07bd34e46.jpg",
    "year": 2013,
    "sha256": "063bb4c8846da2e93517575ecf8fd8ed35fa893527edf9721e833d09b16d8357",
    "uri": "at://did:plc:7vdlgi2bflelz7mmuxoqjfcr/app.rocksky.album/3lhygmahmls2l",
    "artist_uri": "at://did:plc:7vdlgi2bflelz7mmuxoqjfcr/app.rocksky.artist/3lhyge6vpf22l",
    "play_count": 36,
    "unique_listeners": 1
  }
]
Previous
Get Album
Next
Get User's Artists
Built with