Retrieve product recommendations
Obtain personalized product recommendations from the Kameleoon Product Recommendation API using recommender codes.
Query parameters
Response
Path Parameters
ID of the product recommendations block. Find the recommender_code in the blocks management UI.
Query Parameters
Device ID. Get this ID from the KameleoonProducts_device_id cookie. Retrieve it from the backend before calling this endpoint. Only provide did when using filters or algorithms that rely on historical device data, such as "Recently Viewed" or "Recommended for You."
Store Key. Find this in Recommendations > Settings > Store settings in the Kameleoon app. Contact your Customer Success Manager for the key if necessary.
Temporary user session ID. Get this ID from the KameleoonProducts_session_code cookie. Retrieve it from the backend before calling this endpoint. Only provide sid when using filters or algorithms that rely on historical user data, such as "Recently Viewed" or "Recommended for You."
Image size (px) for resizing.
120, 140, 160, 180, 200, 220 Adds extended information for recommended products. If 1, the API returns all product information. If empty, the API returns only product IDs.
If true and extended is also true, the response includes location_ids for all availability places. If extended is missing or false, this parameter is ignored and defaults to false.
Response
The recommendation block's products and rendered HTML.
HTML code for the product block. Customize the HTML template in the Kameleoon personal account.
Block title. Matches the "Action" element value in the block rules.
List of recommended product IDs.
Unique block identifier. Matches the block ID in the Kameleoon personal account.