Recommendations

Recommend Next Item Segments

Returns Item Segments to be shown as the next recommendations when a user scrolls (e.g., within a carousel or feed of Item Segments such as brands, artists, topics, or categories).

The request requires the recommId of a base recommendation request and the number of Segments to return (count).

The base request can be one of:

All other parameters are inherited from the base request associated with the provided recommId.

This endpoint can be called multiple times for a single recommId. Each call returns different Item Segments that have not been recommended in previous calls. The number of calls made so far is returned in the numberNextRecommsCalls field.

Requests can be made up to 30 minutes after the base request or the most recent Recommend Next Item Segments call.

For billing purposes, each call to this endpoint is counted as a separate recommendation request.

post/{databaseId}/recomms/next/item-segments/{recommId}

Path parameters

databaseIdstring required

ID of your database.

recommIdstring required

ID of the base recommendation request for which next recommendations should be returned

Request body

countinteger required

Number of item segments to be recommended

Response

Successful operation.

recommIdstring required

Id of the recommendation request

numberNextRecommsCallsinteger

How many times Recommend Next Items have been called for this recommId

abGroupstring

Name of AB-testing group to which the request belongs if there is a custom AB-testing running.

Changes

No recorded changes to this endpoint across all 1 revision of this API.