- API reference
- Recommendations
Send listening events
Sends what your listeners did: play, complete, skip, like, dislike. At most 1,000 events and 1 MiB in one call. The events build each listener's taste for GET /public/recommendations/users/{userId}/recommendations and POST /public/recommendations/next. An event more than 5 minutes in the future or older than 400 days is rejected and listed with its index; the rest are stored. An ISRC we do not know yet is stored too. Each accepted event counts on your usage. Needs Client Secret authentication.
Request body
application/json · required
Response
events, from 0.{
"accepted": 998,
"rejected": [
{
"index": 0,
"reason": "in_future"
}
]
}
Errors
More than 1,000 events, or an event with a missing or malformed field.
No valid credential.
The request does not use Client Secret authentication.
payload_too_large: the body is larger than 1 MiB.
Your account sent more calls this minute than its rate limit allows.