https://api.nexscope.ai/st/amazon/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/st/amazon/productDetail |
| Autenticación | Bearer API key |
| Content-Type | application/json |
Parámetros de la solicitud
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
asin | string | obligatorio | Número de identificación estándar de Amazon; múltiples ASINs separados por comas, hasta 10, por ejemplo, `B0088PUEPK,B00U26V4VQ`. |
marketplace | string | obligatorio | Códigos de sitio del Amazonas: `us`, `gb`, `de`, `fr`, `in`, `ca`, `jp`, `es`, `it`, `mx`, `ae`, `au`, `br`, `sa`. Usos del Reino Unido `gb`. |
includeTrend | integer | opcional | Si se incluyen datos sobre tendencias: `1` lo hace, `2` no. Por defecto, se devuelve la tendencia de los últimos 15 días. Ejemplo: 1 |
queryTrendStartDate | string | opcional | Fecha de inicio de la tendencia, formato `yyyy-MM-dd`. |
queryTrendEndDate | string | opcional | Fecha de expiración de la tendencia, formato `yyyy-MM-dd`. Cuando se especifica un rango de consulta superior a 15 días, la deducción se duplicará. |
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 (74 campos)
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
code | integer | opcional | Código de respuesta, `200` indica éxito. |
msg | string | opcional | Responda al mensaje. |
total | integer | opcional | Número total de resultados. |
costTime | integer | opcional | Tiempo tomado, unidad ms. |
costToken | integer | opcional | El número de fichas consumidas. |
requestConsumed | integer | opcional | Número de solicitudes recibidas. |
sourceType | string | opcional | Tipo de fuente, el valor es `st`. |
type | string | opcional | Estilo de representación. |
columns | array | opcional | Renderiza la columna. |
products | array | opcional | Lista de detalles del producto; los campos de elementos se muestran en la tabla siguiente. |
asin | string | opcional | ASIN。 |
title | string | opcional | Título del producto. |
brand | string | opcional | marca. |
asinUrl | string | opcional | Amazon Lista de detalle página URL. |
imageUrl | string | opcional | Imagen principal URL. |
productImageUrls | array | opcional | Todas las URLs de imagen del producto. |
ebcPhoto | array | opcional | Una lista de imágenes más. |
storeName | string | opcional | Nombre de la tienda. |
description | string | opcional | Cinco puntos de descripción. |
productBadge | array | opcional | Logos de productos como Amazon Choice, Best Seller, New Release. |
lastUpdate | string | opcional | ASIN última reunión de datos, formato `yyyy-MM-dd`. |
offSale | boolean | opcional | Si lo quitamos de los estantes, `true` indica que no está a la venta. |
productType | string | opcional | Nombre del nodo de categoría de producto Amazon. |
weight | string | opcional | Peso, unidad g. |
size | array | opcional | Dimensiones exteriores del envase `[longest side, second longest side, shortest side]`, unidad cm. |
parentAsin | string | opcional | Padre ASIN; `null` si no hay niños. |
variationNum | integer | opcional | Número de variantes. |
variationASIN | array | opcional | Lista de los ASIN descendientes. |
attribute | array | opcional | Propiedad del niño; el elemento contiene `asin`, `name`, `value`. |
price | number | opcional | Precio de venta real después de deducir cupones, en moneda local. |
coupon | integer | opcional | Política de cupón; no negativo valor es el importe de descuento (como por ejemplo `500` significa $5), el valor negativo es el porcentaje de descuento (como `-10` significa un 10% de descuento). |
platformFee | number | opcional | Comisión de la plataforma, en moneda local. |
fbaFees | number | opcional | Tasas de FBA en moneda local. |
fbaDetail | array | opcional | Detalles de la FBA; el primer artículo es la tarifa de entrega, seguido por la cuota de almacenamiento mensual. |
shipCost | number | opcional | Tasa de entrega de FBM en moneda local. |
shipsFrom | string | opcional | Fiesta de envío. |
profitAmount | number | opcional | Resultado, calculado como precio recibido - comisión de la FBA - comisión, en moneda local. |
profitRate | number | opcional | Margen de beneficio, por ejemplo `25.83` significa el 25,83 %. |
monthlySalesUnits | integer | opcional | El volumen oficial de ventas mensuales de ASIN anunciado por Amazon es el último valor para los últimos 7 días calendario. Si no hay datos, es 0. |
salesRank | integer | opcional | Clasificación de la categoría BSR. |
category | array | opcional | Categoría `[category name, NodeId]`. |
bsrCategory | array | opcional | Lista de clasificación de categorías pequeñas, entre los elementos se incluyen `nodeId`, `name`, `rank`, `date` (`yyyyMMdd`). |
availableDate | string | opcional | Plazo de presentación de la solicitud, formato `yyyy-MM-dd`. |
onlineDays | integer | opcional | Número de días en la estantería. |
rating | number | opcional | Valoración actual, rango 0,0-5.0. |
ratings | integer | opcional | Número de valoraciones. |
fiveStarRatings | number | opcional | 5 estrellas, la unidad es porcentaje. |
fourStarRatings | number | opcional | Cociente de 4 estrellas, unidad es porcentaje. |
threeStarRatings | number | opcional | Cociente de 3 estrellas, unidad es porcentaje. |
twoStarRatings | number | opcional | 2 Star ratio, unidad es porcentaje. |
oneStarRatings | number | opcional | 1 estrella de la relación, unidad es porcentaje. |
buyboxSeller | string | opcional | Buybox nombre del vendedor. |
buyBoxSellerId | string | opcional | ID del vendedor de cajas de compra. |
buyboxSellerAddress | string | opcional | El código de dos dígitos del país/región donde se encuentra el vendedor Buybox; cuando Amazon es auto-operado, es `null`. |
isFBA | boolean | opcional | Haga Buybox vendedores utilizan FBA. |
sellerNum | integer | opcional | Número de vendedores. |
aPlus | boolean | opcional | A+ o no. |
hasVideo | boolean | opcional | ¿Hay un video? |
hasBrandStore | boolean | opcional | ¿Hay una tienda de marcas? |
feature | object | opcional | Características del producto y correspondientes puntuaciones estelares. |
productInfo | object | opcional | Listado Central de información de producto estructurado datos. |
property | object | opcional | Lista y descripción de la propiedad sobre puntos de bala. |
brandPromotion | string | opcional | Promoción de marca. |
dealType | string | opcional | De acuerdo. |
extraSavings | array | opcional | Promociones de afiliados. |
rankTrend | array | opcional | Tendencias de clasificación de categorías de BSR, formato escalonado `[date, ranking, ...]`. |
bsrRankTrend | array | opcional | Tendencia de clasificación de categorías pequeñas, formato `[{NodeId: xxx, Rank: [date, ranking, ...]}]`. |
listingSalesVolumeOfDailyTrend | array | opcional | Evolución de las ventas diarias; `-1` no puede estimarse. |
listingSalesOfDailyTrend | array | opcional | La unidad es la unidad más pequeña de la moneda local; `-1` significa que no puede ser estimado. |
listingSalesVolumeOfMonthTrend | array | opcional | Evolución de las ventas mensuales en los últimos 30 días; `-1` dijo que no puede ser predicho. |
listingSalesOfMonthTrend | array | opcional | Evolución de las ventas mensuales en la unidad más pequeña de la moneda local. |
priceTrend | array | opcional | La tendencia de los precios de venta, antes de que se deduzcan los cupones, es la unidad más pequeña de la moneda local; `-1` significa que no hay precio disponible en ese día. |
listPriceTrend | array | opcional | Subrayar el historial original de precios, la unidad es la unidad más pequeña de la moneda local; `-1` significa que no hay precio disponible en ese día. |
dealTrend | array | opcional | Tendencia de los acuerdos, `1` significa que hay un trato, `0` significa que no hay trato. |
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.