https://api.nexscope.ai/walmart/searchEjecutar esta API
Envía una solicitud JSON para ejecutar esta API y recibir los datos de respuesta documentados.
Endpoint
| Método | POST |
| Ruta | https://api.nexscope.ai/walmart/search |
| Autenticación | Bearer API key |
| Content-Type | application/json |
Parámetros de la solicitud
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
keyword | string | opcional | Buscar palabra clave, longitud máxima 1024 caracteres; proporcionar al menos uno con `categoryId`. |
categoryId | string | opcional | Categoría ID, proporcionar al menos uno con `keyword`; `0` significa todos los departamentos, por ejemplo `976759_976787`. |
sort | string | opcional | Ordenar por: `price_low` (precio de bajo a alto), `price_high` (precio de alto a bajo), `best_seller` (mejor venta), `best_match` (mejor partido). Utiliza el pedido de relevancia por defecto cuando no se especifica. |
page | integer | opcional | Número de página de la paginación, el valor máximo es `100`. Ejemplo: 1 |
minPrice | number | opcional | precio más bajo. |
maxPrice | number | opcional | El precio más alto. |
spelling | boolean | opcional | Indica si se debe activar la corrección ortográfica. Ejemplo: true |
softSort | boolean | opcional | Si se debe ordenar por relevancia; establecer `false` para desactivar. Ejemplo: true |
storeId | string | opcional | Almacenar ID para filtrar productos por una tienda específica. |
device | string | opcional | Tipo de dispositivo: `desktop`, `tablet`, `mobile`. Ejemplo: desktop |
nextDayEnabled | boolean | opcional | Indica si solo se deben mostrar los resultados de entrega de NextDay. Ejemplo: false |
jsonRestrictor | string | opcional | JSON Limitador de campo. |
Respuesta de ejemplo
Estructura de respuesta de la plataforma. code 0 indica éxito o aceptación; data contiene el resultado de negocio.
No hay un ejemplo de respuesta publicado para esta API. Consulta los campos de respuesta siguientes.
Campos de respuesta
Referencia de campos de respuesta (30 campos)
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
total | integer | opcional | Número de registros. |
products | array | opcional | Lista de productos, los campos de elementos se muestran en la tabla de abajo. |
columns | array | opcional | Columnas renderizadas. |
type | string | opcional | Estilo de representación. |
costToken | integer | opcional | El número de fichas consumidas. |
productId | string | opcional | Identificación del producto. |
usItemId | string | opcional | Identificación del producto estadounidense. |
title | string | opcional | Título del producto. |
description | string | opcional | Descripción del producto. |
price | number | opcional | precio actual. |
wasPrice | number | opcional | Precio original. |
currency | string | opcional | unidad monetaria. |
minPrice | number | opcional | precio más bajo. |
pricePerUnitAmount | string | opcional | Precio unitario. |
pricePerUnit | string | opcional | Precio unitario. |
rating | number | opcional | Puntuación. |
reviews | integer | opcional | Número de revisiones. |
sellerName | string | opcional | Nombre del vendedor. |
sellerId | string | opcional | Identificación del vendedor. |
imageUrl | string | opcional | Producto en miniatura URL. |
productPageUrl | string | opcional | Página del producto URL. |
sponsored | boolean | opcional | Si es un producto patrocinado. |
outOfStock | boolean | opcional | ¿Está sin stock? |
freeShipping | boolean | opcional | ¿Es gratis el envío? |
twoDayShipping | boolean | opcional | Si es necesario apoyar el envío de dos días. |
freeShippingWithWalmartPlus | boolean | opcional | ¿Es gratuito el envío para los miembros de Walmart Plus? |
shippingPrice | number | opcional | Gastos de envío. |
multipleOptionsAvailable | boolean | opcional | ¿Hay varias opciones. |
variantSwatches | array | opcional | Muestra de la lista de variantes; cada uno contiene `name`, `imageUrl`, `productPageUrl`, `variantFieldId`. |
sourceType | string | opcional | Tipo de fuente: `walmart`. |
Respuestas
| Código | Descripción |
|---|---|
| 200 | Respuesta HTTP predeterminada tanto para el éxito como para muchos errores de negocio. Solo el código JSON externo 0 indica éxito o aceptación asíncrona; consulta data para obtener el resultado. |
| 429 | Límite de admisión de ejecuciones; respeta Retry-After cuando esté presente. |
| 503 | La admisión de ejecuciones no está disponible temporalmente; respeta Retry-After cuando esté presente. |
| Opcional | X-Nexscope-Http-Status: semantic asigna estados HTTP a los errores de negocio gestionados por el controlador en las rutas de ejecución y tareas. Los fallos previos a la autenticación, como la ausencia de una clave API (code 11209), pueden seguir devolviendo HTTP 200 antes de esta asignación. Comprueba siempre el código JSON externo; las solicitudes malformadas y los fallos de infraestructura también pueden devolver respuestas HTTP distintas de 200. |
Fuente de datos, vigencia y limitaciones
La fuente, la vigencia, la cobertura, los límites de frecuencia y las notas de estimación no se especifican en esta definición de API salvo que aparezcan en la documentación de campos de solicitud o respuesta anterior. No supongas datos oficiales del mercado ni actualización en tiempo real cuando no estén documentados explícitamente.