Rocksky
  1. playlists
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 Album
      • Get Several Albums
    • artists
      • Get User's Artists
      • Get Artist
      • Get Several Artists
    • charts
      • Get Scrobbles Per Day
    • playlists
      • Get User's Playlists
        GET
      • Get Playlist
        GET
    • 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. playlists

Get Playlist

GET
/xrpc/app.rocksky.playlist.getPlaylists
Get a playlist owned by a Rocksky user.

Request

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

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.playlist.getPlaylists?uri=at://did:plc:7vdlgi2bflelz7mmuxoqjfcr/app.rocksky.playlist/3ljwqccczak2o'

Responses

🟢200OK
application/json
Body
playlists
array [object {16}] 
required
id
string 
required
description
string 
required
uri
string  | null 
required
spotifyLink
string 
required
tidalLink
null 
required
appleMusicLink
null 
required
createdBy
string 
required
createdAt
string 
required
updatedAt
string 
required
title
string 
required
coverImageUrl
string 
required
curatorDId
string 
required
curatorName
string 
required
curatorAvatarUrl
string 
required
curatorHandle
string 
required
trackCount
string 
required
Example
{
    "playlists": [
        {
            "id": "rec_cv5vdo5qrj66oj2ji9u0",
            "description": "",
            "uri": null,
            "spotifyLink": "https://open.spotify.com/playlist/7oV5mdOKvRJdHeAYfabByg",
            "tidalLink": null,
            "appleMusicLink": null,
            "createdBy": "rec_cv5a37hqm5a1g8vrjskg",
            "createdAt": "2025-03-08T07:50:56.980Z",
            "updatedAt": "2025-03-08T12:34:52.381Z",
            "title": "Calm",
            "coverImageUrl": "https://mosaic.scdn.co/640/ab67616d00001e020b23cb3f677e458a610e6b09ab67616d00001e025b85c4e27b17be5f4af348e6ab67616d00001e029de7177a5d65ecbfa8bc3109ab67616d00001e02f17f57ecc9934f8a7ab35dd2",
            "curatorDId": "did:plc:d5jvs7uo4z6lw63zzreukgt4",
            "curatorName": "Fitiavana Ramanandafy",
            "curatorAvatarUrl": "https://cdn.bsky.app/img/avatar/plain/did:plc:d5jvs7uo4z6lw63zzreukgt4/bafkreifcgsam3qlqrwxrxe6t7aq6jj4ok7kqijg25r33j26k3cjawu32fm@png",
            "curatorHandle": "fitiavana07.bsky.social",
            "trackCount": "0"
        },
        {
            "id": "rec_cv5vdnlqrj66oj2ji9t0",
            "description": "",
            "uri": null,
            "spotifyLink": "https://open.spotify.com/playlist/3drb52pIGkHF4pbxQ4xRSn",
            "tidalLink": null,
            "appleMusicLink": null,
            "createdBy": "rec_cv5a37hqm5a1g8vrjskg",
            "createdAt": "2025-03-08T07:50:54.508Z",
            "updatedAt": "2025-03-09T13:15:47.874Z",
            "title": "Heavy",
            "coverImageUrl": "https://mosaic.scdn.co/640/ab67616d00001e020d9a6a2a68b4010c5b21a38cab67616d00001e026081278cb62df2757d55633bab67616d00001e02a9184b40e7c18c2a3210ec38ab67616d00001e02f034b00d0a05cd6504b49beb",
            "curatorDId": "did:plc:d5jvs7uo4z6lw63zzreukgt4",
            "curatorName": "Fitiavana Ramanandafy",
            "curatorAvatarUrl": "https://cdn.bsky.app/img/avatar/plain/did:plc:d5jvs7uo4z6lw63zzreukgt4/bafkreifcgsam3qlqrwxrxe6t7aq6jj4ok7kqijg25r33j26k3cjawu32fm@png",
            "curatorHandle": "fitiavana07.bsky.social",
            "trackCount": "0"
        },
        {
            "id": "rec_cv56gklqrj62tg2iioqg",
            "description": "",
            "uri": "at://did:plc:7vdlgi2bflelz7mmuxoqjfcr/app.rocksky.playlist/3ljwqccczak2o",
            "spotifyLink": "https://open.spotify.com/playlist/40fEXcsbQix2oK4QzRPVAl",
            "tidalLink": null,
            "appleMusicLink": null,
            "createdBy": "rec_cug4h6ibhfbm7uq5dte0",
            "createdAt": "2025-03-07T03:30:26.608Z",
            "updatedAt": "2025-03-09T13:07:10.013Z",
            "title": "Hip Hop US",
            "coverImageUrl": "https://mosaic.scdn.co/640/ab67616d00001e0236977e237a8f70ec6c990636ab67616d00001e024f0fd9dad63977146e685700ab67616d00001e026275aeac316378b0dd4f31fdab67616d00001e02e572359074e5da958a922987",
            "curatorDId": "did:plc:7vdlgi2bflelz7mmuxoqjfcr",
            "curatorName": "Tsiry Sandratraina 🦀",
            "curatorAvatarUrl": "https://cdn.bsky.app/img/avatar/plain/did:plc:7vdlgi2bflelz7mmuxoqjfcr/bafkreihkoydiswk2jc46z5ip7l45s66ligct5swneanhnrsnn66y3oxlpm@jpeg",
            "curatorHandle": "tsiry-sandratraina.com",
            "trackCount": "55"
        }
    ]
}
Modified at 2025-06-12 08:51:54
Previous
Get User's Playlists
Next
Get Scrobbles
Built with