app.rocksky.song.matchSong

{
  "$type": "com.atproto.lexicon.schema",
  "defs": {
    "main": {
      "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"
    }
  },
  "id": "app.rocksky.song.matchSong",
  "lexicon": 1
}