> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kameleoon.com/llms.txt
> Use this file to discover all available pages before exploring further.

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

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

Ambas opciones utilizan el mismo endpoint. Use el parámetro `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](#parámetros-de-consulta-adicionales-solo-búsqueda-completa) 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:<ul><li>`id` – ID de la categoría (string)</li><li>`name` – nombre de la categoría (string)</li><li>`url` – URL de la categoría (string)</li><li>`count` – número de productos en la categoría (number)</li></ul>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| `filters`                | array  | Información de filtro. Cada objeto contiene estas propiedades: <ul><li>`filter` – Objeto filtro que contiene estas propiedades:</li><li>`count` – total de productos que coinciden con estos parámetros (number)</li><li>`values` – array de objetos de valor que contienen estas propiedades:</li><li>`value` – etiqueta del valor (string)</li><li>`count` – número de productos con este parámetro (number)</li></ul>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| `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:<ul><li>`min` – precio mínimo (number)</li><li>`max` – precio máximo (number)</li></ul>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| `products`               | array  | Información de producto. Cada objeto contiene estas propiedades:<ul><li>`description` – descripción del producto (string)</li><li>`url` – URL absoluta del producto (string)</li><li>`url_handle` – URL relativa del producto (string)</li><li>`picture` – URL de la imagen del producto en el almacenamiento de Kameleoon (string)</li><li>`name` – nombre del producto (string)</li><li>`price` – precio del producto (integer)</li><li>`price_full` – precio del producto (float)</li><li>`price_formatted` – precio del producto con moneda (string)</li><li>`price_full_formatted` – precio del producto formateado con moneda (string)</li><li>`image_url` - URL absoluta de la imagen del producto en el almacenamiento de Kameleoon (string)</li><li>`image_url_handle` - URL relativa de la imagen del producto en el almacenamiento de Kameleoon (string)</li><li>`image_url_resized` - array de URLs de imágenes redimensionadas</li><li>`currency` – moneda del producto (string)</li><li>`id` – ID del producto (string)</li><li>`old_price` – precio antiguo del producto (integer, por defecto es 0)</li><li>`old_price_full` – precio antiguo del producto (float)</li><li>`old_price_formatted` – precio antiguo del producto con moneda (string)</li><li>`old_price_full_formatted` – precio antiguo del producto formateado con moneda (string)</li><li>Propiedades adicionales si incluye `extended` en la solicitud:<ul><li>`id` – ID de la categoría (string)</li><li>`name` – nombre de la categoría (string)</li><li>`parent_id` – ID de la categoría padre (string)</li><li>`url` - URL de la categoría</li><li>`category_ids` - IDs de las categorías del producto (array)</li></ul></li></ul> |
| `search_query_redirects` | array  | Información de redirección. Cada objeto contiene estas propiedades:<ul><li>`query` – consulta de búsqueda (string)</li><li>`redirect_link` – URL para redirección (string)</li><li>`deep_link` – URL para aplicaciones móviles (string)</li></ul>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| `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:<ul><li>`name` – nombre de la marca (string)</li><li>`picture` – URL de la imagen de la marca (string)</li></ul>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| `categories`     | array  | Información de categoría. Cada objeto contiene estas propiedades:<ul><li>`alias` – alias de la categoría (string)</li><li>`id` – ID de la categoría (string)</li><li>`name` – nombre de la categoría (string)</li><li>`parent` – ID de la categoría padre (string)</li><li>`url` – URL de la categoría (string)</li></ul>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| `filters`        | array  | Información de filtro. Cada objeto contiene estas propiedades:<ul><li>`filter` – Objeto filtro que contiene estas propiedades:<ul><li>`count` – total de productos que coinciden con estos parámetros (number)</li><li>`values` – objetos de valor que contienen `value` (string) y `count` (number)</li></ul></li></ul>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| `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:<ul><li>`min` – precio mínimo (number)</li><li>`max` – precio máximo (number)</li></ul>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| `products`       | array  | Información de producto. Cada objeto contiene estas propiedades:<ul><li>`brand` – marca del producto (string)</li><li>`currency` – moneda del producto (string)</li><li>`id` – ID del producto (string)</li><li>`is_new` – propiedad del producto (boolean, por defecto es null)</li><li>`name` – nombre del producto (string)</li><li>`old_price` – precio antiguo del producto (string, por defecto es 0)</li><li>`picture` – URL de la imagen del producto en el almacenamiento de Kameleoon (string)</li><li>`price` – precio del producto (number)</li><li>`price_formatted` – precio del producto con moneda (string)</li><li>`url` – URL del producto (string)</li><li>Propiedades adicionales si incluye `extended` en la solicitud:<ul><li>`barcode` – código de barras del producto (string)</li></ul></li><li>`categories` – categorías del producto (array) que contiene `id`, `name` y `parent` ID.</li><li>`params` – información de parámetro. Cada objeto contiene `key` (string) y `values` (array).</li></ul> |
| `products_total` | number | Conteo total de productos.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| `search_query`   | string | Consulta de búsqueda.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |