# List recommendation genres
URL: https://musicapi.com/docs/reference/recommendations-genres.md

`GET https://api.musicapi.com/public/recommendations/genres`

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.

The genres that a playlist seed may name, the largest first. `artistCount` is the number of artists behind the genre's vector. Each call counts as one recommendation request on your usage.

## Response 200

ok

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `modelVersion` | string | yes | The model version that made the answer. |
| `genres` | object[] | yes |  |
| `genres[].genre` | string | yes |  |
| `genres[].artistCount` | number | yes |  |

```json
{
  "modelVersion": "2026-11-13",
  "genres": [
    {
      "genre": "dream pop",
      "artistCount": 1520
    }
  ]
}
```

## Errors

- 401: No valid credential.
- 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/genres \
  -u "$MUSICAPI_CLIENT_ID:$MUSICAPI_CLIENT_SECRET"
```
