Recommendations (v2)
Recommend For User
Returns an object with an array of recommendation displays.
Each display will contain a recommendation_id (which is also present as a URL parameter in `display.page_url`).
The recommendation_id should be sent to the `create-events` endpoint if the user interacts with the recommendation.
This is typically achieved by storing the recommendation as a data attribute on the HTML element containing the recommendation.
Example response:
<pre>
{
"displays": [{
"title": "Mechanical Keyboard",
"price": "100.00",
"image_url": "https://my_store.com/awesome_mechanical_keyboard.jpeg",
"page_url": "https://my_store.com/awesome_mechanical_keyboard.html",
"product_id": "awesome_mechanical_keyboard",
"recommendation_id": "827ada29-92e7-4642-8805-8b7105a9c8a5"
}]
}
</pre>
POST
/
v2
/
recommend
/
products
/
general
Query Parameters
Body
application/json
Identifier associated with the API integration
Market identifier
Type of the recommendation, e.g. cross_sell
Locale identifier
Maximum number of recommendations returned.
Required range:
1 < x < 128
Customer identifier
Session identifier
Populated for integrations performed by Depict.ai only. Depict.ai Session Id
Minimum length:
1
Metadata that can be used to modify the behaviour of the recommendation system
Was this page helpful?