https://api.nexscope.ai/st/walmart/productAnalysisEjecutar 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/st/walmart/productAnalysis |
| Autenticación | Bearer API key |
| Content-Type | application/json |
Parámetros de la solicitud
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
operation | string | opcional | Requerido; sólo `searchByName`, `detail`, `trend`, `salesVolume` |
name | string | opcional | `searchByName` requerido; no vacío idioma natural nombre del producto |
productId | string | opcional | `detail`, `trend`, `salesVolume` requerido; no vacío Walmart ProductId |
queryDate | string | opcional | Fecha de inicio en el formato `yyyy-MM-dd` |
queryEndDate | string | opcional | Fecha de finalización, en el formato de `yyyy-MM-dd`; cuando sólo se da la fecha de inicio, el valor predeterminado es el día actual |
pageIndex | integer | opcional | `searchByName`, `salesVolume` comienza desde 1, por defecto a 1; máximo 100 elementos por página |
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 (59 campos)
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
errcode | integer | opcional | Código de estado de la capa de la capa de la puerta de enlace; `200` indica que la solicitud entró con éxito en la respuesta empresarial |
errmsg | string | opcional | Mensaje de estado de la capa de framework de pasarela; típicamente `ok` sobre el éxito |
code | integer | opcional | `200` indica éxito |
msg | string | opcional | mensaje de respuesta |
data | object | opcional | Contenedor de respuesta fija; `data.value` conserva el objeto primitivo ST de cada operación, matriz, escalar, o `null` |
operation | string | opcional | `searchByName`, `detail`, `trend` o `salesVolume` ejecutada esta vez |
requestConsumed | integer | opcional | Este consumo previo; cuando el anterior no está o devuelve 0, se completa según el consumo de documento de la operación; cuando ST explícitamente devuelve `Code=11` (sin datos), permanece 0 |
costTime | integer | opcional | Tiempo tomado, la unidad es milisegundos |
costToken | integer / absent | opcional | Cabeza de respuesta de puerta de entrada de producción `X-Cost-Token`; el script de entrada será copiado a este campo, y este campo está faltando actualmente al analizar el JSON cuerpo directamente. |
costCredit | integer / absent | opcional | Cabeza de respuesta de puerta de entrada de producción `X-Cost-Credit`, que es la potencia de cálculo real deducido esta vez; el script de entrada será copiado a este campo |
sourceType | string | opcional | `st` |
searchByName | array<object> | opcional | Productos relacionados matriz resumen |
detail | object | opcional | Único producto detalles objeto |
trend | object | opcional | Objeto de tendencia de un solo producto |
salesVolume | array<array> | opcional | Ventas registro fila array; cada fila es `[date, sales, type]` |
Title | string | opcional | Título del producto |
Photo | array<string> | opcional | Imagen del producto URL matriz |
ListingSalesVolumeOfMonth | integer | opcional | Volumen de ventas estimado en los últimos 30 días en la dimensión de la Lista, sin distinguir entre variantes |
ListingSalesOfMonth | integer | opcional | Ventas estimadas en los últimos 30 días en la dimensión de la Lista; la unidad para el sitio de EE.UU. es de centavos |
ProductId | string | opcional | Walmart ProductId |
ParentProductId | string | opcional | Producto principal |
Price | integer | opcional | Precio de venta; la unidad de sitio de EE.UU. es centavos, como `1999` significa `$19.99` |
Brand | string | opcional | marca |
Seller | string | opcional | Nombre del vendedor en el momento de la recogida |
Shipedby | string | opcional | El método de entrega en el momento de la recogida; el nombre del campo es la ortografía original de la corriente |
WFSFee | integer | opcional | Tasa WFS; unidad de sitio de EE.UU. es centavos |
Attribute | array<string> / null | opcional | Atributos del producto, codificación interdejada según `[attribute name, attribute value, ...]` |
FirstReviewsDate | string / null | opcional | Fecha del primer comentario en el formato `yyyy-MM-dd` |
ReviewsCount | integer | opcional | Número de comentarios |
Ratings | number | opcional | Calificación, como `4.8` |
NodePath | array<string\|null> | opcional | Los registros de categorías y rankings se agrupan y codifican de acuerdo con `[category name, NodeId, ranking date, ranking, ...]`; cuando falta el ranking en un determinado día, la posición correspondiente es `null` |
Label | array<string> | opcional | Etiquetas de productos, como `pickup`, `savewith`, `bestsell` |
PopularPick | integer | opcional | Etiqueta popular de selección; `1` indica existencia |
Clearance | integer | opcional | Marca de limpieza; `1` indica existencia |
ReducedPrice | integer | opcional | Precio reducido; `1` indica existencia |
Rollback | integer | opcional | Token de retorno; `1` indica existencia |
FlashDeal | integer | opcional | Etiqueta de acuerdo Flash; `1` indica existencia |
Size | array<string> / null | opcional | Tamaño del envase exterior `[longest side, second longest side, shortest side]`, unidad es cm |
Weight | number | opcional | Peso del producto en gramos |
Variants | array / null | opcional | Datos de la variante; `searchByName` está codificado de manera diferente a `detail`, véase más abajo |
NumberOfStar | array<number\|string> / null | opcional | El número de comentarios para cada clasificación de estrellas, según `[star rating, number of reviews, ...]` codificación escalonada |
Pickup | integer | opcional | Extensión de detalle: marca de etiqueta de recogida; `1` indica existencia |
Savewith | integer | opcional | Extensión de detalle: Guardar con marca de etiqueta; `1` indica existencia |
Bestseller | integer | opcional | Extensión de detalle: etiqueta Best Seller; `1` indica existencia |
UpdateDate | string / null | opcional | Detalle extensión: tiempo de actualización de datos del producto, generalmente `yyyy-MM-dd` |
VariantId | string | opcional | ID de producto de la variante (ProductId) |
Url | string | opcional | Producto variante URL |
Property | array<string> | opcional | Atributos variantes, codificados por `[attribute name, attribute value, ...]` |
PriceUpdate | string / null | opcional | Tiempo de actualización del precio, generalmente `yyyy-MM-dd` |
DetailUpdate | string / null | opcional | Tiempo de actualización de detalles, generalmente `yyyy-MM-dd`; cuando no hay fecha válida, los marcadores de posición ascendentes como `--` puede utilizarse |
ProductId | string | opcional | Walmart ProductId |
ListingSalesVolumeOfMonth | integer | opcional | Volumen estimado de ventas de la dimensión actual de la Lista en los últimos 30 días |
ListingSalesOfMonth | integer | opcional | Ventas estimadas de la dimensión actual de la Lista en los últimos 30 días; la unidad para el sitio de los EE.UU. es centavos |
ListingSalesVolumeOfMonthTrend | array<string> | opcional | Historial de ventas mensual, codificado por `[yyyy-MM-dd, sales volume, ...]` |
ListingSalesOfMonthTrend | array<string> | opcional | Historial de ventas mensual, codificado por `[yyyy-MM-dd, sales, ...]`; unidad de cantidad es centavos |
PriceTrend | array<string> | opcional | Historial de precios, codificado por `[yyyy-MM-dd, price, ...]`; las cantidades se expresan en centavos |
ReviewsTrend | array<string> | opcional | Historial de cuenta de comentarios, codificado por `[yyyy-MM-dd, comment count, ...]` |
StarTrend | array<string> | opcional | Historial de calificación, codificado como `[yyyy-MM-dd, rating, ...]`; valor de ejemplo de respuesta actual es `5.00` |
RankTrend | array<array<string>> | opcional | Historial de clasificación de cada categoría; cada fila está codificada por `[category name, NodeId, date, ranking, date, ranking, ...]` |
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.