# Recommend similar artists
URL: https://musicapi.com/docs/reference/recommendations-similar-artists.md

`GET https://api.musicapi.com/public/recommendations/similar-artists`

Section: Recommendations.
Product: MusicAPI Core.
Auth: Basic, Token, DevToken, DocsSession (any one of them). Use Basic with your Client ID and Client Secret from your server only.

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

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `isrc` | string | no | An ISRC of a track of the seed artist. Send this or `artistId`. |
| `artistId` | string | no | The seed artist's id, from `artist.id` of an earlier answer. Send this or `isrc`. |
| `limit` | number | no | How many results to return. Default: `20`. |

## Response 200

ok

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `modelVersion` | string | yes | The model version that made the answer. |
| `artists` | object[] | yes |  |
| `artists[].artistId` | string | yes |  |
| `artists[].name` | string | yes |  |
| `artists[].score` | number | yes |  |

```json
{
  "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.

## Example

```bash
curl https://api.musicapi.com/public/recommendations/similar-artists \
  -u "$MUSICAPI_CLIENT_ID:$MUSICAPI_CLIENT_SECRET"
```
