Skip to main content
GET
cURL

Query Parameters

artist
string

Artist name; Recoup resolves the first provider search match. Required unless id is supplied. Recoup artist UUID resolution is not implemented here.

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
string

Optional raw string; no Recoup default. For similar artists, only a positive integer limits the returned list; for playlists it passes through to the provider.

id
string

Research artist ID returned by search or lookup; treat it as an opaque string. Required unless artist is supplied; takes precedence when both are provided. This is not a Recoup artist/account ID.

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

"artist_123"

Response

Unweighted related artists with provider fields; no overlap scores are computed.

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

status
string
Example:

"success"

artists
object[]
total
integer

Only present if the adapter receives a provider total; not guaranteed.