Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.rocksky.app/llms.txt

Use this file to discover all available pages before exploring further.

The Rocksky API is an XRPC (AT Protocol) API. Every endpoint lives under the app.rocksky.* namespace and is reachable at https://api.rocksky.app/xrpc/<nsid>.

​
Base URL

https://api.rocksky.app

​
Authentication

Authenticated endpoints expect a bearer token in the Authorization header: 
Authorization: Bearer <your_jwt>
You can obtain a token by: Read-only endpoints (profiles, charts, public scrobble feeds, search) work without authentication.

​
Audioscrobbler endpoints

For Last.fm / ListenBrainz compatibility, Rocksky exposes a separate host: 
https://audioscrobbler.rocksky.app

​
SDKs

Prefer typed bindings? Use one of the official SDKs in TypeScript, Python, Rust, Go, Ruby, Kotlin, Elixir, Clojure, or Gleam — every endpoint in this reference is wrapped.

​
Errors

Non-2xx responses return an XRPC-style error body: 
{
  "error": "InvalidRequest",
  "message": "actor must be a DID or handle"
}
The HTTP status code carries the category (400-class for client errors, 500-class for server errors).

​
OpenAPI spec

The endpoint reference below is generated directly from the OpenAPI specification shipped with this site.