Skip to the content
  1. API reference
  2. Recommendations

Recommend similar artists

GET/public/recommendations/similar-artists
CoreAuthBasicTokenDevTokenDocsSession

Finds artists like the seed artist. Name the seed by artistId (from an earlier answer) or by isrc (any track of the artist). Send exactly one of the two. The seed artist is never in the answer. Each call counts as one recommendation request on your usage.

Query parameters

isrc
string

An ISRC of a track of the seed artist. Send this or artistId.

artistId
string

The seed artist's id, from artist.id of an earlier answer. Send this or isrc.

limit
number · 20

How many results to return.

Response

200application/json · RecommendationSimilarArtistsResponseok
modelVersion
string
requiredThe model version that made the answer.
artists
object[]
required
artists[].artistId
string
required
artists[].name
string
required
artists[].score
number
required
Example answer
{
  "modelVersion": "2026-11-13",
  "artists": [
    {
      "artistId": "123456",
      "name": "LaziiBee",
      "score": 0.91
    }
  ]
}

Errors

400

Neither or both of isrc and artistId, or limit out of range.

401

No valid credential.

404

no_signal: the seed artist has no vector.

429

Your account sent more calls this minute than its rate limit allows.

503

model_not_ready: no recommendation model is active yet. Try again later. temporarily_unavailable: the recommendation index is loading or busy (for example right after a weekly model swap). Try again after the Retry-After seconds.