Skip to main content
GET
/
api
/
research
/
similar
cURL
curl --request GET \
  --url https://recoup-api.vercel.app/api/research/similar
{
  "status": "success",
  "artists": [
    {
      "name": "<string>",
      "id": 123,
      "similarity": 123,
      "career_stage": "<string>",
      "recent_momentum": "<string>",
      "sp_followers": 123,
      "sp_monthly_listeners": 123
    }
  ],
  "total": 123
}

Query Parameters

artist
string
required

Artist name or Recoup artist ID (UUID).

audience
enum<string>

Audience overlap weight.

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

Genre similarity weight.

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

Mood similarity weight.

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

Musicality similarity weight.

Available options:
high,
medium,
low
limit
integer
default:10

Response

200 - application/json

Similar artists with overlap scores

status
enum<string>
Available options:
success,
error
artists
object[]
total
integer