Skip to main content
GET
Request product list
Este endpoint recupera una lista de productos.
Kameleoon no incluye el objeto filters en la respuesta si no utiliza los parámetros de consulta categories o filters.

Parámetros de consulta

Respuesta

Propiedades de marca

Campos de categoría

Propiedades del filtro

Campos de rango del filtro

Campos del rango de precio

Campos del producto

Propiedades de categoría de producto

Propiedades de parámetro

Parámetros de consulta

did
string
requerido

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
requerido

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
requerido

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.

Respuesta

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.