search_artist

🟡 Incomplete

This API's output may have additions in the future.

Input a string, retrieve an array of Artist's, sorted by how similar their names are to the input.

Inputs

FieldTypeDescription
inputstringThe string to match against, to use as input
kindstring, one of all, sim60, sim70, sim80, top25, top5, top1See Search/Kind

Outputs

FieldTypeDescription
artistsarray of Artist objectsAn array of Artist objects, sorted by most similar name first

Example Request

festival-cli search_artist --input twice --kind sim70

curl http://localhost:18425 -d '{"jsonrpc":"2.0","id":0,"method":"search_artist","params":{"input":"twice","kind":"sim70"}}'

Example Response

{
  "jsonrpc": "2.0",
  "result": {
    "artists": [
      {
        "name": "TWICE",
        "key": 106,
        "runtime": 343,
        "albums": [
          598
        ],
        "songs": [
          5411
        ]
      }
    ]
  },
  "id": 0
}