Skip to main content
GET
/
api
/
research
/
similar
cURL
curl --request GET \
  --url https://api.recoupable.dev/api/research/similar
{
  "status": "success",
  "artists": [
    {
      "id": "wjcgfd9i",
      "name": "Drake",
      "avatar": "<string>",
      "site_url": "<string>"
    }
  ]
}

Query Parameters

​
artist
string

Artist name. Required unless id is provided.

​
audience
enum<string>
default:medium

Audience overlap weight.

Available options:
high,
medium,
low
​
genre
enum<string>
default:medium

Genre similarity weight.

Available options:
high,
medium,
low
​
mood
enum<string>
default:medium

Mood similarity weight.

Available options:
high,
medium,
low
​
musicality
enum<string>
default:medium

Musicality similarity weight.

Available options:
high,
medium,
low
​
limit
integer
default:10
​
id
string

Provider artist ID returned by lookup or search. Required unless artist is provided.

Pattern: ^[A-Za-z0-9][A-Za-z0-9._:-]*$
Example:

"artist_123"

Response

Similar artists with overlap scores

Similar artists. Similarity is unweighted (no score/ranking fields).

​
status
string
Example:

"success"

​
artists
object[]