app.rocksky.song.matchSong Documentation (EN)

main query

Matches a song against Rocksky’s music database and external metadata providers to resolve the best canonical track, artist, and album

Parameters

artist string Required

The artist of the song to retrieve

isrc string Optional

Optional International Standard Recording Code (ISRC) to anchor the match

mbId string Optional

Optional MusicBrainz recording ID to anchor the match

title string Required

The title of the song to retrieve

Output

Encodingapplication/json

Schemaapp.rocksky.song.defs#songViewDetailed

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

artist * The artist of the song to retrieve

isrc Optional International Standard Recording Code (ISRC) to anchor the match

mbId Optional MusicBrainz recording ID to anchor the match

title * The title of the song to retrieve

View raw schema

{
  "description": "Matches a song against Rocksky’s music database and external metadata providers to resolve the best canonical track, artist, and album",
  "output": {
    "encoding": "application/json",
    "schema": {
      "ref": "app.rocksky.song.defs#songViewDetailed",
      "type": "ref"
    }
  },
  "parameters": {
    "properties": {
      "artist": {
        "description": "The artist of the song to retrieve",
        "type": "string"
      },
      "isrc": {
        "description": "Optional International Standard Recording Code (ISRC) to anchor the match",
        "type": "string"
      },
      "mbId": {
        "description": "Optional MusicBrainz recording ID to anchor the match",
        "type": "string"
      },
      "title": {
        "description": "The title of the song to retrieve",
        "type": "string"
      }
    },
    "required": [
      "title",
      "artist"
    ],
    "type": "params"
  },
  "type": "query"
}