- API reference
- 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
{
"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.