https://api.nexscope.ai/ws/productDetailEjecutar 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/ws/productDetail |
| Autenticación | Bearer API key |
| Content-Type | application/json |
Parámetros de la solicitud
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
productId | integer | obligatorio | ID del elemento (ID del elemento), el ID numérico contenido en el enlace de detalles del producto, como `5169493923` en `https://www.walmart.com/ip/5169493923`. |
includeStats | boolean | opcional | Si se deben incluir los datos históricos de precios y ventas. Ejemplo: true |
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 (38 campos)
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
code | string | opcional | Código de retorno; `"200"` indica éxito. |
msg | string | opcional | Mensaje; `"ok"` sobre el éxito, la descripción de error sobre el fracaso. |
total | integer | opcional | La cantidad de mercancías devueltas es generalmente 1 para esta interfaz. |
products | array | opcional | Lista de productos, los campos de elementos se muestran en la tabla de abajo. |
columns | array | opcional | Definición de la columna, describiendo la meta información de cada campo en `products`, incluidos `field`, `title`, `cellType`, etc. |
type | string | opcional | Tipo de renderizado de respuesta, el valor fijo es `"productWorkbenches"`. |
costTime | integer | opcional | La interfaz toma tiempo en milisegundos. |
costToken | integer | opcional | El número de fichas consumidas. |
usItemId | integer | opcional | El ID interno del producto, que es `productId` en la solicitud. |
productId | string | opcional | Un identificador único para el producto Walmart, que puede ser una cadena alfanumérica. |
title | string | opcional | Nombre del producto. |
description | string | opcional | Descripción del producto. |
price | number | opcional | Precio de venta actual en dólares estadounidenses. |
wasPrice | number/null | opcional | Precio de la huelga en USD; puede ser `null` sin descuento. |
minPrice | number | opcional | El precio más bajo en USD. |
brand | string | opcional | Marca de fábrica. |
rating | number | opcional | Puntuación del producto, que va desde 0,0–5.0. |
reviews | integer | opcional | Número de comentarios. |
salesEstimate | integer | opcional | Estimación del volumen de ventas para el ciclo reciente, en unidades. |
revenue | number | opcional | Estimaciones de ingresos en dólares de los EE.UU. |
sellerName | string | opcional | Nombre del vendedor. |
fulfillmentType | string | opcional | Tipo de envío: `MARKETPLACE` (cumplido por un tercero vendedor) o `WFS` (Servicios de Cumplimiento de Walmart). |
productPageUrl | string | opcional | Página del producto URL. |
imageUrl | string | opcional | Imagen del producto URL (tumbnail). |
departmentName | string | opcional | El nombre del departamento al que perteneces. |
departmentId | integer | opcional | Identificación del departamento. |
listingScore | integer | opcional | Listado de la puntuación de calidad. |
contentScore | integer | opcional | Puntos de calidad de contenido. |
outOfStock | integer | opcional | Si está fuera de stock: `0`= en reserva, `1`= sin existencias. |
sponsored | integer | opcional | Si se deben anunciar productos: `0`=No, `1`=Sí. |
isBranded | integer | opcional | Si es un producto de marca: `0`=No, `1`=Sí. |
multipleOptionsAvailable | integer | opcional | ¿Hay variaciones: `0`=No, `1`=Sí. |
createdAt | string | opcional | ws Primer tiempo de recogida, en el formato de `yyyy-MM-dd'T'HH:mm:ss.SSSSSS'Z'`. |
updatedAt | string | opcional | La última actualización de datos, el formato es el mismo que el anterior. |
stats | object/null | opcional | Estadísticas históricas; devuelto si `includeStats=true`, en caso contrario `null`. |
sourceType | string | opcional | Plataforma de origen del producto, el valor fijo es `"walmart"`. |
stats.price | array | opcional | Serie histórica de tiempo de venta, ordenada por fecha en orden ascendente. |
stats.sales | array | opcional | Serie histórica de tiempo de ventas, ordenada por fecha en orden ascendente. |
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.