- API reference
- Recommendations
Recommend the next tracks
The next tracks of a listening session. recent lists the tracks just played, newest first; newer tracks count more. skipped steers away. With userId, the listener's taste counts too (30%). The answer never holds recent, skipped or exclude. With userId, the call needs Client Secret authentication, and an answered call counts the listener as a personalised user of the month. Without userId, any credential works.
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"
}
}
]
}
Errors
A malformed ISRC, or a list or limit out of range.
No valid credential.
userId is set, and the request does not use Client Secret authentication.
no_signal: no recent track has a vector and the listener has no usable events. 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.