> ## 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. # Implementar la lógica de búsqueda en su backend o aplicación móvil > Muestre resultados de búsqueda de productos en vivo y completos en su backend o aplicación móvil usando la Product Recommendation API de Kameleoon. Esta guía explica cómo consultar la Product Recommendation API para mostrar resultados de búsqueda de productos en vivo (instantáneos) y completos sin incrustar el elemento HTML de Kameleoon. Consulte la [guía de integración visual](/user-manual/recommendations-and-merchandising/recommendations/enable-kameleoon-search-capabilities#technical-implementation-of-kameleoon-instant-search) para el método visual. El tutorial utiliza el **[endpoint search](../all-endpoints/Search/get-search)**. ## ¿Por qué usar la API? Use la API para aplicaciones móviles. Según sus necesidades, este enfoque ofrece múltiples ventajas: * **Control total**: Personalice la visualización de la variación para que coincida con sus estándares de diseño y UX. * **Mejor rendimiento**: Utilice llamadas a la API optimizadas para reducir los retrasos de carga de la página en comparación con las soluciones basadas en script. * **Depuración más sencilla**: Registre, supervise y depure las integraciones dentro de su base de código del cliente utilizando herramientas estándar. * **Sin dependencia de scripts de terceros**: Utilice llamadas directas para evitar scripts externos, reducir conflictos potenciales y alinearse con las políticas de seguridad. * **Compatible con SPAs**: Integre directamente en aplicaciones de una sola página para evitar problemas de tiempo y encajar con el enrutamiento del lado del cliente. * **Resistencia frente a bloqueadores de anuncios**: Entregue los experimentos de forma consistente sin scripts de terceros ni marcadores HTML específicos. Para más detalles sobre cómo afectan los bloqueadores de anuncios a Kameleoon, consulte las **[FAQ](../../../feature-experimentation/technical-reference/faq-global#how-do-ad-blockers-affect-kameleoon)**. ## Objetivo Recuperar y mostrar resultados de búsqueda de productos según la entrada del usuario utilizando el modo de búsqueda instantánea (typeahead) o completa. ## Requisitos * Una cuenta de Kameleoon válida con un **Store ID (`shop_id`)**. * Obtenga su `shop_id` en **Recommendations** > **Settings** > **Store settings** en la aplicación Kameleoon. Contacte con su Customer Success Manager para obtener la clave si es necesario. ![Store Key](https://storage.googleapis.com/kameleoon-storage-documentation/developers/images/api-tutorial/store-key.jpg) * Un **Device ID (`did`)** y un **Session ID (`sid`)**. (Obligatorios solo cuando se utilicen filtros o algoritmos que dependan de datos históricos de dispositivo/usuario). * Para **Kameleoon Web Experimentation**, obténgalos de las siguientes cookies: * `KameleoonProducts_device_id` → **Device ID (`did`)** * `KameleoonProducts_session_code` → **Session ID (`sid`)** * En caso contrario, genere estos valores manualmente. ## Pasos ### 1. Configurar el feed para Kameleoon search Siga la [guía de configuración de búsqueda](/user-manual/recommendations-and-merchandising/recommendations/enable-kameleoon-search-capabilities) para configurar su feed. ### 2. Recuperar las cookies (solo Kameleoon Web Experimentation) Genere estos valores manualmente para implementaciones de backend o entornos sin Kameleoon Web Experimentation. Consulte el **[endpoint Init](../all-endpoints/Initialize/init)** para más detalles. ```javascript theme={null} function getCookie(name) { const match = document.cookie.match(new RegExp('(^| )' + name + '=([^;]+)')); if (match) return match[2]; } const did = getCookie('KameleoonProducts_device_id'); const sid = getCookie('KameleoonProducts_session_code'); ``` ### 3. Realizar una solicitud de búsqueda La API admite dos tipos de búsqueda: #### a. Búsqueda instantánea (instant\_search) Utilice la búsqueda instantánea para resultados de typeahead y autocompletado a medida que el usuario escribe. **Endpoint:** ``` GET https://api.products.kameleoon.com/search ``` | Nombre | Tipo | Obligatorio | Descripción | | :------------- | :----- | :---------- | :--------------------------------------------- | | `did` | string | True | Device ID (desde la cookie) | | `sid` | string | True | Session ID (desde la cookie) | | `shop_id` | string | True | Su ID de tienda de Kameleoon | | `type` | string | True | `"instant_search"` | | `search_query` | string | True | Entrada de búsqueda del usuario | | `locations` | List | False | Lista separada por comas de IDs de ubicaciones | **Ejemplo:** ```bash theme={null} curl -X GET -L 'https://api.products.kameleoon.com/search' \ -H 'Content-Type: application/json' \ -d '{ "did":"abc123", "sid":"xyz456", "shop_id":"demoShop", "type":"instant_search", "search_query":"decon", }' ``` #### b. Búsqueda completa (full\_search) Utilice la búsqueda completa para mostrar resultados detallados con filtros, categorías, paginación y ordenación. **Endpoint:** ``` GET https://api.products.kameleoon.com/search ``` | Nombre | Tipo | Obligatorio | Descripción | | :------------- | :------------ | :---------- | :----------------------------------------------- | | `did` | string | True | Device ID (desde la cookie) | | `sid` | string | True | Session ID (desde la cookie) | | `shop_id` | string | True | Su ID de tienda de Kameleoon | | `type` | string | True | `"full_search"` | | `search_query` | string | True | Entrada de búsqueda del usuario | | `locations` | List | False | Lista separada por comas de IDs de ubicaciones | | `limit` | Integer | False | Número máximo de resultados | | `offset` | Integer | False | Desplazamiento para la paginación | | `extended` | Integer/Empty | False | `1` devuelve los datos completos del producto | | `sort_by` | String | False | Criterio de ordenación: `popular`, `price`, etc. | | `order` | String | False | Orden: `asc` o `desc` | | `brands` | List | False | Filtrar por lista de marcas | | `categories` | List | False | Filtrar por lista de categorías | | `filters` | String | False | Cadena JSON escapada para parámetros de producto | | `price_min` | Integer | False | Precio mínimo | | `price_max` | Integer | False | Precio máximo | | `exclude` | List | False | IDs de productos a excluir | ```bash theme={null} curl -X GET -L 'https://api.products.kameleoon.com/search' \ -H 'Content-Type: application/json' \ -d '{ "did":"abc123", "sid":"xyz456", "shop_id":"demoShop", "type":"full_search", "search_query":"decon", "limit":"10", "extended":"1", "sort_by":"price", "order":"asc", }' ``` Consulte la [sección de filtrado](#aplicar-filtros) para los detalles del filtrado. ### 4. Integrar la respuesta #### a. Búsqueda instantánea Si la solicitud tiene éxito, la API devuelve un fragmento HTML para inyectarlo directamente en la página, junto con los datos de productos y categorías para un renderizado personalizado. ![Instant Search](https://storage.googleapis.com/kameleoon-storage-documentation/developers/images/api-tutorial/instant-search.jpg) Para aplicaciones móviles, utilice los arrays JSON de productos y categorías para diseñar una interfaz nativa. ##### Respuesta de ejemplo ```json theme={null} { "search_query": "decon", "collections": [], "products_total": 1, "products": [ { "name": "VANS | SK8-HI DECON (CUTOUT)| LEAVES\/WHITE", "url": "\/products\/asics-tiger-gel-lyte-v-30-years-of-gel-pack?recommended_by=instant_search&recommended_code=decon", "category_ids": [ "1", "2", "295508017316" ], "barcode": "VN-05-white-4", "vendor_code": "VA", "brand": "Vans", "leftovers": "lot", "rating": 5, "fashion_sizes": [ "4", "5", "6", "7", "8", "9", "10" ], "fashion_feature": "adult", "fashion_gender": "m", "fashion_wear_type": "shoe", "fashion_original_sizes": [ "4", "5", "6", "7", "8", "9", "10" ], "picture": "https:\/\/images.products.kameleoon.com\/resize-images\/180\/9fa630bf863db7a87fc6d5fd2a188f\/3927252.jpg", "categories": [ { "id": "1", "url": "\/collections\/all?recommended_by=instant_search&recommended_code=decon", "name": "Men", "level": "1", "url_handle": "\/collections\/all?recommended_by=instant_search&recommended_code=decon" }, { "id": "2", "url": "\/collections\/all?recommended_by=instant_search&recommended_code=decon", "name": "Women", "level": "1", "url_handle": "\/collections\/all?recommended_by=instant_search&recommended_code=decon" }, { "id": "295508017316", "parent_id": "1", "url": "\/collections\/all?recommended_by=instant_search&recommended_code=decon", "name": "Men - Sneakers", "level": "2", "url_handle": "\/collections\/all?recommended_by=instant_search&recommended_code=decon" } ], "price_formatted": "$ 179", "price_full_formatted": "$ 179.95", "price": 179, "price_full": 179.95, "image_url": "https:\/\/cdn.shopify.com\/s\/files\/1\/0564\/9180\/2788\/products\/327cd936d9a9c409cd8b36987158013f_grande.jpg?v=1622707484", "image_url_handle": "\/s\/files\/1\/0564\/9180\/2788\/products\/327cd936d9a9c409cd8b36987158013f_grande.jpg?v=1622707484", "image_url_resized": { "120": "https:\/\/images.products.kameleoon.com\/resize-images\/120\/9fa630bf863db7a87fc6d5fd2a188f\/3927252.jpg", "140": "https:\/\/images.products.kameleoon.com\/resize-images\/140\/9fa630bf863db7a87fc6d5fd2a188f\/3927252.jpg", "160": "https:\/\/images.products.kameleoon.com\/resize-images\/160\/9fa630bf863db7a87fc6d5fd2a188f\/3927252.jpg", "180": "https:\/\/images.products.kameleoon.com\/resize-images\/180\/9fa630bf863db7a87fc6d5fd2a188f\/3927252.jpg", "200": "https:\/\/images.products.kameleoon.com\/resize-images\/200\/9fa630bf863db7a87fc6d5fd2a188f\/3927252.jpg", "220": "https:\/\/images.products.kameleoon.com\/resize-images\/220\/9fa630bf863db7a87fc6d5fd2a188f\/3927252.jpg", "310": "https:\/\/images.products.kameleoon.com\/resize-images\/310\/9fa630bf863db7a87fc6d5fd2a188f\/3927252.jpg", "520": "https:\/\/images.products.kameleoon.com\/resize-images\/520\/9fa630bf863db7a87fc6d5fd2a188f\/3927252.jpg", "original": "https:\/\/cdn.shopify.com\/s\/files\/1\/0564\/9180\/2788\/products\/327cd936d9a9c409cd8b36987158013f_grande.jpg?v=1622707484" }, "url_handle": "\/products\/asics-tiger-gel-lyte-v-30-years-of-gel-pack?recommended_by=instant_search&recommended_code=decon", "currency": "$", "_id": "3927252", "id": "VN-05-white-4", "stock_quantity": 19, "fashion_colors": [ "white" ], "params": [ { "key": "Size", "values": [ "4" ] }, { "key": "Color", "values": [ "white" ] } ], "group_id": "_3927252_" } ], "categories": [ { "id": "1", "name": "Men", "url": "\/collections\/all?recommended_by=instant_search&recommended_code=decon", "url_handle": "\/collections\/all?recommended_by=instant_search&recommended_code=decon", "count": 1 }, { "id": "2", "name": "Women", "url": "\/collections\/all?recommended_by=instant_search&recommended_code=decon", "url_handle": "\/collections\/all?recommended_by=instant_search&recommended_code=decon", "count": 1 }, { "id": "295508017316", "name": "Men - Sneakers", "parent": "1", "url": "\/collections\/all?recommended_by=instant_search&recommended_code=decon", "url_handle": "\/collections\/all?recommended_by=instant_search&recommended_code=decon", "count": 1 } ], "clarification": true, "requests_count": 1, "queries": [], "html": "
Categories <\/div>
Men <\/span><\/a> Women <\/span><\/a> Men - Sneakers <\/span><\/a> <\/div> <\/div> <\/div>
Possible item matches <\/div>
<\/div>
VANS | SK8-HI DECON (CUTOUT)| LEAVES\/WHITE <\/div>
$ 179.95 <\/div> <\/a> <\/div> <\/div> <\/div>
<\/div><\/div>" } ``` #### a. Búsqueda completa La integración de la **búsqueda completa** también proporciona un **fragmento HTML** para mostrar los resultados. La respuesta también incluye los arrays `brands` y `filters` además del array `categories`. El array `filters` contiene claves y valores de los campos `params` del producto. Utilícelos para construir la interfaz de filtrado. Ejemplo de página de resultados de búsqueda completa: ![Full Search](https://storage.googleapis.com/kameleoon-storage-documentation/developers/images/api-tutorial/full-search.jpg) #### Aplicar filtros El siguiente ejemplo muestra la solicitud de búsqueda completa con los filtros seleccionados en la imagen anterior: ```json theme={null} { "did":"abc123", "shop_id":"9fa630bf863db7a87fc6d5fd2a188f", "type":"full_search", "search_query":"vans", "input_query":"vans", "categories":"295508017316", "filters":{"Color":["white"],"Size":["4"]}, "brands":"vans" } ``` ##### Respuesta de ejemplo ```json theme={null} { "search_query": "decon", "collections": [], "products_total": 1, "products": [ { "name": "VANS | SK8-HI DECON (CUTOUT)| LEAVES\/WHITE", "url": "\/products\/asics-tiger-gel-lyte-v-30-years-of-gel-pack?recommended_by=full_search&recommended_code=decon", "category_ids": [ "1", "2", "295508017316" ], "barcode": "VN-05-white-4", "vendor_code": "VA", "brand": "Vans", "leftovers": "lot", "rating": 5, "fashion_sizes": [ "4", "5", "6", "7", "8", "9", "10" ], "fashion_feature": "adult", "fashion_gender": "m", "fashion_wear_type": "shoe", "fashion_original_sizes": [ "4", "5", "6", "7", "8", "9", "10" ], "picture": "https:\/\/images.products.kameleoon.com\/resize-images\/180\/9fa630bf863db7a87fc6d5fd2a188f\/3927252.jpg", "categories": [ { "id": "1", "url": "\/collections\/all?recommended_by=full_search&recommended_code=decon", "name": "Men", "level": "1", "url_handle": "\/collections\/all?recommended_by=full_search&recommended_code=decon" }, { "id": "2", "url": "\/collections\/all?recommended_by=full_search&recommended_code=decon", "name": "Women", "level": "1", "url_handle": "\/collections\/all?recommended_by=full_search&recommended_code=decon" }, { "id": "295508017316", "parent_id": "1", "url": "\/collections\/all?recommended_by=full_search&recommended_code=decon", "name": "Men - Sneakers", "level": "2", "url_handle": "\/collections\/all?recommended_by=full_search&recommended_code=decon" } ], "price_formatted": "$ 179", "price_full_formatted": "$ 179.95", "price": 179, "price_full": 179.95, "image_url": "https:\/\/cdn.shopify.com\/s\/files\/1\/0564\/9180\/2788\/products\/327cd936d9a9c409cd8b36987158013f_grande.jpg?v=1622707484", "image_url_handle": "\/s\/files\/1\/0564\/9180\/2788\/products\/327cd936d9a9c409cd8b36987158013f_grande.jpg?v=1622707484", "image_url_resized": { "120": "https:\/\/images.products.kameleoon.com\/resize-images\/120\/9fa630bf863db7a87fc6d5fd2a188f\/3927252.jpg", "140": "https:\/\/images.products.kameleoon.com\/resize-images\/140\/9fa630bf863db7a87fc6d5fd2a188f\/3927252.jpg", "160": "https:\/\/images.products.kameleoon.com\/resize-images\/160\/9fa630bf863db7a87fc6d5fd2a188f\/3927252.jpg", "180": "https:\/\/images.products.kameleoon.com\/resize-images\/180\/9fa630bf863db7a87fc6d5fd2a188f\/3927252.jpg", "200": "https:\/\/images.products.kameleoon.com\/resize-images\/200\/9fa630bf863db7a87fc6d5fd2a188f\/3927252.jpg", "220": "https:\/\/images.products.kameleoon.com\/resize-images\/220\/9fa630bf863db7a87fc6d5fd2a188f\/3927252.jpg", "310": "https:\/\/images.products.kameleoon.com\/resize-images\/310\/9fa630bf863db7a87fc6d5fd2a188f\/3927252.jpg", "520": "https:\/\/images.products.kameleoon.com\/resize-images\/520\/9fa630bf863db7a87fc6d5fd2a188f\/3927252.jpg", "original": "https:\/\/cdn.shopify.com\/s\/files\/1\/0564\/9180\/2788\/products\/327cd936d9a9c409cd8b36987158013f_grande.jpg?v=1622707484" }, "url_handle": "\/products\/asics-tiger-gel-lyte-v-30-years-of-gel-pack?recommended_by=full_search&recommended_code=decon", "currency": "$", "_id": "3927252", "id": "VN-05-white-4", "stock_quantity": 19, "fashion_colors": [ "white" ], "params": [ { "key": "Size", "values": [ "4" ] }, { "key": "Color", "values": [ "white" ] } ], "group_id": "_3927252_" } ], "price_range": { "min": 179.95000000000002, "max": 179.95000000000002 }, "price_ranges": [ { "from": 10, "count": 1 } ], "price_median": 0, "filters": { "Color": { "count": 1, "values": { "white": 1 } }, "Size": { "count": 1, "values": { "4": 1 }, "ranges": { "min": "4", "max": "4" } } }, "brands": [ { "name": "Vans", "count": 1 } ], "categories": [ { "id": "1", "name": "Men", "url": "\/collections\/all?recommended_by=full_search&recommended_code=decon", "url_handle": "\/collections\/all?recommended_by=full_search&recommended_code=decon", "count": 1 }, { "id": "2", "name": "Women", "url": "\/collections\/all?recommended_by=full_search&recommended_code=decon", "url_handle": "\/collections\/all?recommended_by=full_search&recommended_code=decon", "count": 1 }, { "id": "295508017316", "name": "Men - Sneakers", "parent": "1", "url": "\/collections\/all?recommended_by=full_search&recommended_code=decon", "url_handle": "\/collections\/all?recommended_by=full_search&recommended_code=decon", "count": 1 } ], "industrial_filters": { "fashion_sizes": [ { "size": 4, "count": 1 }, { "size": 5, "count": 1 }, { "size": 6, "count": 1 }, { "size": 7, "count": 1 }, { "size": 8, "count": 1 }, { "size": 9, "count": 1 }, { "size": 10, "count": 1 } ], "colors": [ { "color": "white", "count": 1 } ] }, "clarification": true, "requests_count": 1, "html": "
<\/a> <\/div>
VANS | SK8-HI DECON (CUTOUT)| ...<\/a> <\/div>
$ 179.95 <\/div> <\/div> <\/div>" } ``` ## Notas * Asegúrese de que las cookies sean accesibles antes de hacer las solicitudes. * Utilice la búsqueda completa con `extended=1` para listados de productos detallados, como en las páginas de producto. * Personalice el HTML devuelto o renderice una interfaz personalizada utilizando la respuesta JSON. se.