Skip to main content
GET
Request product list
Cet endpoint récupère une liste de produits.
Kameleoon n’inclut pas l’objet filters dans la réponse si vous n’utilisez pas les paramètres de requête categories ou filters.

Paramètres de requête

Réponse

Propriétés des marques

Champs de catégorie

Propriétés des filtres

Champs de fourchette de filtre

Champs de fourchette de prix

Champs de produit

Propriétés de catégorie de produit

Propriétés des paramètres

Paramètres de requête

did
string
requis

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
requis

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
requis

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.

Réponse

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.