- API reference
- Recommendations
Generate a playlist
Builds a playlist from seeds: ISRCs, artist ids and genres (from GET /public/recommendations/genres), each with an optional weight. The seeds become one taste vector. The answer leaves out the seed tracks and exclude, keeps at most maxPerArtist tracks of one artist, and mixes near duplicates down the list. A seed that resolves to nothing is listed in unresolved; the rest still count. shuffleSeed shuffles the list inside groups of 5, so the same seed gives the same order and a new seed gives a fresh one. Each call counts as one recommendation request on your usage.
Request body
application/json · required
Response
catalogue: your own ISRC of the track. Else one ISRC of the track.{
"modelVersion": "2026-11-13",
"tracks": [
{
"isrc": "USRC17607839",
"score": 0.8731,
"title": "Forests",
"artist": {
"id": "123456",
"name": "LaziiBee"
}
}
],
"unresolved": [
"string"
]
}
Errors
No seed, a malformed seed, or length out of range.
No valid credential.
no_signal: no seed resolved. catalogue_not_found: the catalogue does not exist or is not yours.
catalogue_not_ready: the catalogue is still processing.
Your account sent more calls this minute than its rate limit allows.
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.