Skip to main content
GET
Request product list
This endpoint retrieves a list of products.
Kameleoon doesn’t include the 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

did
string
required

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."

sid
string
required

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."

shop_id
string
required

Store Key. Find this in Recommendations > Settings > Store settings in the Kameleoon app. Contact your Customer Success Manager for the key if necessary.

limit
integer

Maximum number of results the API returns.

page
integer

Maximum number of pages the API returns.

locations
string[]

Comma-separated list of location IDs.

brands
string[]

Comma-separated list of brands for filtering.

merchants
string[]

Comma-separated list of merchants for filtering.

categories
string[]

Comma-separated list of categories for filtering.

filters
string

Escaped JSON string with filter parameters. Example: {"bluetooth":["yes"],"offers":["15% cashback"],"weight":["1.6"]}

filters_search_by
string

Filter search options: name, quantity, popularity.

Response

200 - application/json

Matching products and facet information. Response shape verified against a live call on 2026-09-24.

brands
object[]

Brand facet information.

categories
object[]

Category facet information.

filters
object

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.

price_range
object
products
object[]

Matching products.

products_total
integer

Total count of matching products.

price_ranges
object[]

Distribution of products across price ranges.

price_median
number

Median product price.