app.rocksky.song.getSongs Documentation (EN)

main query

Get songs

Parameters

genre string Optional

The genre to filter artists by

isrc string Optional

Filter songs by International Standard Recording Code (ISRC)

limit integer Optional

The maximum number of songs to return

mbid string Optional

Filter songs by MusicBrainz ID

offset integer Optional

The offset for pagination

spotifyId string Optional

Filter songs by Spotify track ID (resolved internally to the Spotify track URL)

Output

Encodingapplication/json

songs array Optional

No description available.

Try It

Requests are sent directly from your browser. Some servers may block requests due to CORS.

Service Endpoint Base URL for XRPC calls (e.g., https://api.bsky.social)

Parameters

genre The genre to filter artists by

isrc Filter songs by International Standard Recording Code (ISRC)

limit The maximum number of songs to return

mbid Filter songs by MusicBrainz ID

offset The offset for pagination

spotifyId Filter songs by Spotify track ID (resolved internally to the Spotify track URL)

View raw schema

{
  "type": "query",
  "output": {
    "schema": {
      "type": "object",
      "properties": {
        "songs": {
          "type": "array",
          "items": {
            "ref": "app.rocksky.song.defs#songViewBasic",
            "type": "ref"
          }
        }
      }
    },
    "encoding": "application/json"
  },
  "parameters": {
    "type": "params",
    "properties": {
      "isrc": {
        "type": "string",
        "description": "Filter songs by International Standard Recording Code (ISRC)"
      },
      "mbid": {
        "type": "string",
        "description": "Filter songs by MusicBrainz ID"
      },
      "genre": {
        "type": "string",
        "description": "The genre to filter artists by"
      },
      "limit": {
        "type": "integer",
        "minimum": 1,
        "description": "The maximum number of songs to return"
      },
      "offset": {
        "type": "integer",
        "minimum": 0,
        "description": "The offset for pagination"
      },
      "spotifyId": {
        "type": "string",
        "description": "Filter songs by Spotify track ID (resolved internally to the Spotify track URL)"
      }
    }
  },
  "description": "Get songs"
}