Skip to the content
  1. API reference
  2. Recommendations

List recommendation genres

GET/public/recommendations/genres
CoreAuthBasicTokenDevTokenDocsSession

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

200application/json · RecommendationGenresResponseok
modelVersion
string
requiredThe model version that made the answer.
genres
object[]
required
genres[].genre
string
required
genres[].artistCount
number
required
Example answer
{
  "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.