Récupérer les résultats de recherche

Retrieve search results

curl --request GET \
  --url https://api.products.kameleoon.com/search

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.products.kameleoon.com/search",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.products.kameleoon.com/search"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.products.kameleoon.com/search")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body

{
  "search_query": "<string>",
  "search_query_original": "<string>",
  "collections": [
    {}
  ],
  "categories": [
    {
      "id": "<string>",
      "name": "<string>",
      "url": "<string>",
      "url_handle": "<string>",
      "count": 123,
      "parent": "<string>",
      "alias": "<string>"
    }
  ],
  "filters": {},
  "html": "<string>",
  "price_range": {
    "min": 123,
    "max": 123
  },
  "price_ranges": [
    {
      "from": 123,
      "to": 123,
      "count": 123
    }
  ],
  "price_median": 123,
  "products": [
    {
      "name": "<string>",
      "url": "<string>",
      "url_handle": "<string>",
      "category_ids": [
        "<string>"
      ],
      "categories": [
        {
          "id": "<string>",
          "url": "<string>",
          "name": "<string>",
          "level": "<string>",
          "url_handle": "<string>"
        }
      ],
      "barcode": "<string>",
      "vendor_code": "<string>",
      "brand": "<string>",
      "leftovers": "<string>",
      "rating": 123,
      "fashion_feature": "<string>",
      "fashion_gender": "<string>",
      "fashion_wear_type": "<string>",
      "fashion_sizes": [
        "<string>"
      ],
      "fashion_original_sizes": [
        "<string>"
      ],
      "fashion_colors": [
        "<string>"
      ],
      "picture": "<string>",
      "price_formatted": "<string>",
      "price_full_formatted": "<string>",
      "price": 123,
      "price_full": 123,
      "image_url": "<string>",
      "image_url_handle": "<string>",
      "image_url_resized": {},
      "currency": "<string>",
      "_id": "<string>",
      "id": "<string>",
      "stock_quantity": 123,
      "params": [
        {
          "key": "<string>",
          "values": [
            "<string>"
          ]
        }
      ],
      "group_id": "<string>",
      "description": "<string>",
      "is_new": true,
      "old_price": "<string>",
      "sales_rate": 123,
      "relative_sales_rate": 123
    }
  ],
  "products_total": 123,
  "search_query_redirects": [
    {
      "query": "<string>",
      "redirect_link": "<string>",
      "deep_link": "<string>"
    }
  ],
  "brands": [
    {
      "name": "<string>",
      "picture": "<string>",
      "count": 123
    }
  ],
  "clarification": true,
  "requests_count": 123,
  "queries": [
    {
      "name": "<string>",
      "url": "<string>",
      "url_handle": "<string>",
      "score": 123
    }
  ],
  "industrial_filters": {
    "fashion_sizes": [
      {
        "size": "<string>",
        "count": 123
      }
    ],
    "colors": [
      {
        "color": "<string>",
        "count": 123
      }
    ]
  }
}

GET

Retrieve search results

curl --request GET \
  --url https://api.products.kameleoon.com/search

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.products.kameleoon.com/search",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.products.kameleoon.com/search"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.products.kameleoon.com/search")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body

{
  "search_query": "<string>",
  "search_query_original": "<string>",
  "collections": [
    {}
  ],
  "categories": [
    {
      "id": "<string>",
      "name": "<string>",
      "url": "<string>",
      "url_handle": "<string>",
      "count": 123,
      "parent": "<string>",
      "alias": "<string>"
    }
  ],
  "filters": {},
  "html": "<string>",
  "price_range": {
    "min": 123,
    "max": 123
  },
  "price_ranges": [
    {
      "from": 123,
      "to": 123,
      "count": 123
    }
  ],
  "price_median": 123,
  "products": [
    {
      "name": "<string>",
      "url": "<string>",
      "url_handle": "<string>",
      "category_ids": [
        "<string>"
      ],
      "categories": [
        {
          "id": "<string>",
          "url": "<string>",
          "name": "<string>",
          "level": "<string>",
          "url_handle": "<string>"
        }
      ],
      "barcode": "<string>",
      "vendor_code": "<string>",
      "brand": "<string>",
      "leftovers": "<string>",
      "rating": 123,
      "fashion_feature": "<string>",
      "fashion_gender": "<string>",
      "fashion_wear_type": "<string>",
      "fashion_sizes": [
        "<string>"
      ],
      "fashion_original_sizes": [
        "<string>"
      ],
      "fashion_colors": [
        "<string>"
      ],
      "picture": "<string>",
      "price_formatted": "<string>",
      "price_full_formatted": "<string>",
      "price": 123,
      "price_full": 123,
      "image_url": "<string>",
      "image_url_handle": "<string>",
      "image_url_resized": {},
      "currency": "<string>",
      "_id": "<string>",
      "id": "<string>",
      "stock_quantity": 123,
      "params": [
        {
          "key": "<string>",
          "values": [
            "<string>"
          ]
        }
      ],
      "group_id": "<string>",
      "description": "<string>",
      "is_new": true,
      "old_price": "<string>",
      "sales_rate": 123,
      "relative_sales_rate": 123
    }
  ],
  "products_total": 123,
  "search_query_redirects": [
    {
      "query": "<string>",
      "redirect_link": "<string>",
      "deep_link": "<string>"
    }
  ],
  "brands": [
    {
      "name": "<string>",
      "picture": "<string>",
      "count": 123
    }
  ],
  "clarification": true,
  "requests_count": 123,
  "queries": [
    {
      "name": "<string>",
      "url": "<string>",
      "url_handle": "<string>",
      "score": 123
    }
  ],
  "industrial_filters": {
    "fashion_sizes": [
      {
        "size": "<string>",
        "count": 123
      }
    ],
    "colors": [
      {
        "color": "<string>",
        "count": 123
      }
    ]
  }
}

Le service Kameleoon Search propose deux types de recherche :

Instant (typeahead) search : affiche et met à jour les résultats au fur et à mesure que les utilisateurs saisissent leurs requêtes de recherche.
Full search : renvoie des résultats de recherche complets et filtrés après que l’utilisateur a soumis une requête de recherche.

Les deux options utilisent le même endpoint. Utilisez le paramètre type pour spécifier le type de recherche.

Paramètres de requête

Ces paramètres de requête s’appliquent à la fois à la full search et à l’instant search. Utilisez les paramètres supplémentaires uniquement avec la full search.

Paramètre	Type	Requis	Description
`did`	String	True	Device ID. Obtenez cet ID à partir du cookie `KameleoonProducts_device_id`. Récupérez-le depuis le backend avant d’appeler cet endpoint. Ne fournissez `did` que lorsque vous utilisez des filtres ou des algorithmes qui reposent sur des données historiques de l’appareil, comme “Recently Viewed” ou “Recommended for You.”
`sid`	String	True	ID de session utilisateur temporaire. Obtenez cet ID à partir du cookie `KameleoonProducts_session_code`. Récupérez-le depuis le backend avant d’appeler cet endpoint. Ne fournissez `sid` que lorsque vous utilisez des filtres ou des algorithmes qui reposent sur des données historiques de l’utilisateur, comme “Recently Viewed” ou “Recommended for You.”
`shop_id`	String	True	Store Key. Trouvez-le dans Recommendations > Settings > Store settings dans l’application Kameleoon. Contactez votre Customer Success Manager pour obtenir la clé si nécessaire.
`type`	String	True	Spécifie le type de recherche : `instant_search` ou `full_search`.
`search_query`	String	True	Requête de recherche actuelle.
`locations`	List	Optionnel	Liste séparée par des virgules des IDs de lieux.

Paramètres de requête supplémentaires (full search uniquement)

Utilisez ces paramètres supplémentaires avec les requêtes full search (type=full_search).

Paramètre	Type	Requis	Description
`limit`	Integer	Optionnel	Nombre maximum de résultats que l’API renvoie.
`offset`	Integer	Optionnel	Décalage des résultats.
`category_limit`	Integer	Optionnel	Nombre maximum de catégories pour le filtre latéral.
`categories`	List	Optionnel	Liste séparée par des virgules des catégories pour le filtrage.
`extended`	Integer or empty	Optionnel	Ajoute des informations étendues pour les résultats des produits. Valeurs prises en charge : `1` ou vide. Si `1`, l’API renvoie toutes les informations sur le produit. Si vide, l’API ne renvoie que les IDs des produits. Kameleoon recommande de définir cette valeur sur `1` pour la full search.
`sort_by`	String	Optionnel	Paramètre de tri. Valeurs prises en charge : `popular`, `price`, `discount`, `sales_rate`, `date`.
`order`	String	Optionnel	Direction du tri : `asc` (ascendant) ou `desc` (descendant). La valeur par défaut est `desc`.
`brands`	List	Optionnel	Liste séparée par des virgules des marques pour le filtrage.
`filters`	String	Optionnel	Chaîne JSON échappée avec des paramètres de filtre. Exemple : `{"bluetooth":["yes"],"offers":["15% cashback"],"weight":["1.6"]}`
`price_min`	Integer	Optionnel	Prix minimum.
`price_max`	Integer	Optionnel	Prix maximum.
`colors`	List	Optionnel	Liste séparée par des virgules des couleurs.
`exclude`	List	Optionnel	Liste séparée par des virgules des IDs de produits à exclure des résultats de recherche.

Réponse (instant search)

Nom	Type	Description
`search_query`	string	Requête de recherche.
`categories`	array	Informations sur les catégories. Chaque objet contient ces propriétés : `id` – ID de la catégorie (string) `name` – nom de la catégorie (string) `url` – URL de la catégorie (string) `count` – nombre de produits dans la catégorie (number)
`filters`	array	Informations sur les filtres. Chaque objet contient ces propriétés : `filter` – Objet filtre contenant ces propriétés : `count` – nombre total de produits correspondant à ces paramètres (number) `values` – tableau d’objets de valeur contenant ces propriétés : `value` – libellé de la valeur (string) `count` – nombre de produits avec ce paramètre (number)
`html`	string	Code HTML pour le bloc de produits. Personnalisez le template dans le compte personnel Kameleoon.
`price_range`	object	Prix minimum et maximum des produits. Contient ces propriétés : `min` – prix minimum (number) `max` – prix maximum (number)
`products`	array	Informations sur les produits. Chaque objet contient ces propriétés : `description` – description du produit (string) `url` – URL absolue du produit (string) `url_handle` – URL relative du produit (string) `picture` – URL de l’image du produit dans le stockage Kameleoon (string) `name` – nom du produit (string) `price` – prix du produit (integer) `price_full` – prix du produit (float) `price_formatted` – prix du produit avec devise (string) `price_full_formatted` – prix du produit formaté avec devise (string) `image_url` - URL absolue de l’image du produit dans le stockage Kameleoon (string) `image_url_handle` - URL relative de l’image du produit dans le stockage Kameleoon (string) `image_url_resized` - tableau d’URLs d’images redimensionnées `currency` – devise du produit (string) `id` – ID du produit (string) `old_price` – ancien prix du produit (string, par défaut 0) `old_price_full` – ancien prix du produit (float) `old_price_formatted` – ancien prix du produit avec devise (string) `old_price_full_formatted` – ancien prix du produit formaté avec devise (string) Propriétés supplémentaires si vous incluez `extended` dans la requête : `id` – ID de la catégorie (string) `name` – nom de la catégorie (string) `parent_id` – ID de la catégorie parente (string) `url` - URL de la catégorie `category_ids` - IDs des catégories du produit (array)
`search_query_redirects`	array	Informations de redirection. Chaque objet contient ces propriétés : `query` – requête de recherche (string) `redirect_link` – URL pour la redirection (string) `deep_link` – URL pour les applications mobiles (string)
`products_total`	number	Nombre total de produits.

Réponse (full search)

Nom	Type	Description
`brands`	array	Informations sur les marques. Chaque objet contient ces propriétés : `name` – nom de la marque (string) `picture` – URL de l’image de la marque (string)
`categories`	array	Informations sur les catégories. Chaque objet contient ces propriétés : `alias` – alias de la catégorie (string) `id` – ID de la catégorie (string) `name` – nom de la catégorie (string) `parent` – ID de la catégorie parente (string) `url` – URL de la catégorie (string)
`filters`	array	Informations sur les filtres. Chaque objet contient ces propriétés : `filter` – Objet filtre contenant ces propriétés : `count` – nombre total de produits correspondant à ces paramètres (number) `values` – objets de valeur contenant `value` (string) et `count` (number)
`html`	string	Code HTML pour le bloc de produits. Personnalisez le template dans le compte personnel Kameleoon.
`price_range`	object	Prix minimum et maximum des produits. Contient ces propriétés : `min` – prix minimum (number) `max` – prix maximum (number)
`products`	array	Informations sur les produits. Chaque objet contient ces propriétés : `brand` – marque du produit (string) `currency` – devise du produit (string) `id` – ID du produit (string) `is_new` – propriété du produit (boolean, par défaut null) `name` – nom du produit (string) `old_price` – ancien prix du produit (string, par défaut 0) `picture` – URL de l’image du produit dans le stockage Kameleoon (string) `price` – prix du produit (number) `price_formatted` – prix du produit avec devise (string) `url` – URL du produit (string) Propriétés supplémentaires si vous incluez `extended` dans la requête : `barcode` – code-barres du produit (string) `categories` – catégories du produit (array) contenant `id`, `name` et l’ID `parent`. `params` – informations sur les paramètres. Chaque objet contient `key` (string) et `values` (array).
`products_total`	number	Nombre total de produits.
`search_query`	string	Requête de recherche.

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.

type

enum<string>

requis

Specifies the search type.

Options disponibles:

instant_search,

full_search

search_query

string

requis

Current search query.

locations

string[]

Comma-separated list of location IDs.

limit

integer

Maximum number of results the API returns. Full search only.

offset

integer

Result offset. Full search only.

category_limit

integer

Maximum number of categories for the sidebar filter. Full search only.

Réponse

200 - application/json

Matching products for the search query. Verified against a live response on 2026-09-24. The exact response shape depends on type: instant search additionally returns queries, and full search additionally returns brands, price_ranges, price_median, and (with extended=1) industrial_filters.

Response shape verified against a live response on 2026-09-24. Fields kept from the original reference but not observed in that sample (search_query_redirects) may still appear conditionally. queries was observed for instant search; industrial_filters was observed for full search with extended=1.

search_query

string

The search query, as processed by Kameleoon.

search_query_original

string

The search query exactly as submitted.

collections

object[]

Matching product collections, if any.

APIs

​Paramètres de requête

​Paramètres de requête supplémentaires (full search uniquement)

​Réponse (instant search)

​Réponse (full search)

Paramètres de requête

Réponse

Paramètres de requête

Paramètres de requête supplémentaires (full search uniquement)

Réponse (instant search)

Réponse (full search)