Request product list
Retrieve a list of products from the Kameleoon Product Recommendation API with optional filtering and categorization.
filters object in the response if you don’t use the categories or filters query parameters.Query parameters
Response
Brand properties
Category fields
Filter properties
Filter range fields
Price range fields
Product fields
Product category properties
Parameter properties
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."
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."
Store Key. Find this in Recommendations > Settings > Store settings in the Kameleoon app. Contact your Customer Success Manager for the key if necessary.
Maximum number of results the API returns.
Maximum number of pages the API returns.
Comma-separated list of location IDs.
Comma-separated list of brands for filtering.
Comma-separated list of merchants for filtering.
Comma-separated list of categories for filtering.
Escaped JSON string with filter parameters. Example: {"bluetooth":["yes"],"offers":["15% cashback"],"weight":["1.6"]}
Filter search options: name, quantity, popularity.
Response
Matching products and facet information. Response shape verified against a live call on 2026-09-24.
Brand facet information.
Category facet information.
A map of filter name (for example, "Color", "Size") to that filter's aggregation. Verified against a live response on 2026-09-24; the original reference documented filters as an array, but the API actually returns an object keyed by filter name.
Matching products.
Total count of matching products.
Distribution of products across price ranges.
Median product price.