Recuperar resultados de búsqueda
curl --request GET \
--url https://api.example.com/endpointimport requests
url = "https://api.example.com/endpoint"
response = requests.get(url)
print(response.text)const options = {method: 'GET'};
fetch('https://api.example.com/endpoint', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.example.com/endpoint",
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.example.com/endpoint"
req, _ := http.NewRequest("GET", url, nil)
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.example.com/endpoint")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.example.com/endpoint")
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_bodyBúsqueda
Recuperar resultados de búsqueda
Consulte el servicio Kameleoon Search para recuperar resultados de búsqueda de productos instantáneos o completos según la entrada del usuario.
GET
/
endpoint
Recuperar resultados de búsqueda
curl --request GET \
--url https://api.example.com/endpointimport requests
url = "https://api.example.com/endpoint"
response = requests.get(url)
print(response.text)const options = {method: 'GET'};
fetch('https://api.example.com/endpoint', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.example.com/endpoint",
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.example.com/endpoint"
req, _ := http.NewRequest("GET", url, nil)
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.example.com/endpoint")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.example.com/endpoint")
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_bodyEl servicio Kameleoon Search ofrece dos tipos de búsqueda:
- Búsqueda instantánea (typeahead): Muestra y actualiza los resultados a medida que los usuarios escriben las consultas de búsqueda.
- Búsqueda completa: Devuelve los resultados de búsqueda completos y filtrados después de que el usuario envíe una consulta de búsqueda.
type para especificar el tipo de búsqueda.
Solicitud
GET https://api.products.kameleoon.com/search
Parámetros de consulta
Estos parámetros de consulta se aplican tanto a la búsqueda completa como a la búsqueda instantánea. Utilice parámetros adicionales solo con la búsqueda completa.| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
did | String | True | Device ID. Obtenga este ID de la cookie KameleoonProducts_device_id. Recupérelo desde el backend antes de llamar a este endpoint. Proporcione did solo cuando utilice filtros o algoritmos que dependan de datos históricos del dispositivo, como “Recently Viewed” o “Recommended for You”. |
sid | String | True | ID de sesión temporal del usuario. Obtenga este ID de la cookie KameleoonProducts_session_code. Recupérelo desde el backend antes de llamar a este endpoint. Proporcione sid solo cuando utilice filtros o algoritmos que dependan de datos históricos del usuario, como “Recently Viewed” o “Recommended for You”. |
shop_id | String | True | Store Key. Encuéntrela en Recommendations > Settings > Store settings en la aplicación Kameleoon. Contacte con su Customer Success Manager para obtener la clave si es necesario. |
type | String | True | Especifica el tipo de búsqueda: instant_search o full_search. |
search_query | String | True | Consulta de búsqueda actual. |
locations | List | Opcional | Lista separada por comas de IDs de ubicaciones. |
Parámetros de consulta adicionales (solo búsqueda completa)
Utilice estos parámetros adicionales con solicitudes de búsqueda completa (type=full_search).
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
limit | Integer | Opcional | Número máximo de resultados que devuelve la API. |
offset | Integer | Opcional | Desplazamiento del resultado. |
category_limit | Integer | Opcional | Número máximo de categorías para el filtro de la barra lateral. |
categories | List | Opcional | Lista separada por comas de categorías para filtrar. |
extended | Integer o vacío | Opcional | Añade información extendida para los resultados de producto. Valores admitidos: 1 o vacío. Si es 1, la API devuelve toda la información del producto. Si está vacío, la API devuelve solo los IDs de los productos. Kameleoon recomienda establecer esto en 1 para la búsqueda completa. |
sort_by | String | Opcional | Parámetro de ordenación. Valores admitidos: popular, price, discount, sales_rate, date. |
order | String | Opcional | Dirección de ordenación: asc (ascendente) o desc (descendente). El valor por defecto es desc. |
brands | List | Opcional | Lista separada por comas de marcas para filtrar. |
filters | String | Opcional | Cadena JSON escapada con parámetros de filtro. Ejemplo: {"bluetooth":["yes"],"offers":["15% cashback"],"weight":["1.6"]} |
price_min | Integer | Opcional | Precio mínimo. |
price_max | Integer | Opcional | Precio máximo. |
colors | Integer | Opcional | Lista separada por comas de colores. |
exclude | Integer | Opcional | Lista separada por comas de IDs de productos a excluir de los resultados de búsqueda. |
Respuesta (búsqueda instantánea)
| Nombre | Tipo | Descripción |
|---|---|---|
search_query | string | Consulta de búsqueda. |
categories | array | Información de categoría. Cada objeto contiene estas propiedades:
|
filters | array | Información de filtro. Cada objeto contiene estas propiedades:
|
html | string | Código HTML para el bloque de producto. Personalice la plantilla en la cuenta personal de Kameleoon. |
price_range | object | Precios mínimo y máximo del producto. Contiene estas propiedades:
|
products | array | Información de producto. Cada objeto contiene estas propiedades:
|
search_query_redirects | array | Información de redirección. Cada objeto contiene estas propiedades:
|
products_total | number | Número total de productos. |
Respuesta (búsqueda completa)
| Nombre | Tipo | Descripción |
|---|---|---|
brands | array | Información de marca. Cada objeto contiene estas propiedades:
|
categories | array | Información de categoría. Cada objeto contiene estas propiedades:
|
filters | array | Información de filtro. Cada objeto contiene estas propiedades:
|
html | string | Código HTML para el bloque de producto. Personalice la plantilla en la cuenta personal de Kameleoon. |
price_range | object | Precios mínimo y máximo del producto. Contiene estas propiedades:
|
products | array | Información de producto. Cada objeto contiene estas propiedades:
|
products_total | number | Conteo total de productos. |
search_query | string | Consulta de búsqueda. |
¿Esta página le ayudó?
Obtener recomendaciones de producto
Anterior
Importar un catálogo de productos a Kameleoon usando la Product Recommendation API
Siguiente
⌘I