https://api.nexscope.ai/kp/productSeriesEjecutar 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/kp/productSeries |
| 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 del Amazonas (ASIN), sólo soporta una sola ASIN, la longitud máxima es 1000. |
domain | string | obligatorio | nombre de dominio amazon ID: `1` (Estados Unidos), `2` (UK), `3` (Alemania), `4` (Francia), `5` (Japón), `6` (Canadá), `8` (Italia), `9` (España), `10` (India), `11` (México), `12` (Brasil). |
days | integer | opcional | Limitar el número de días de datos históricos a un máximo de `365`. Ejemplo: 90 |
showPrice | integer | opcional | Establecer a `1` devolver la curva de precios más baja del mercado. |
showPriceList | integer | opcional | Establecer a `1` para devolver la curva de golpe/marca. |
showPriceDeal | integer | opcional | Establecer a `1` para devolver la curva de precios de venta flash. |
showPricePrime | integer | opcional | Establecer a `1` para devolver Prime exclusiva nueva curva de precios del producto. |
showPriceFba | integer | opcional | Establecer a `1` para devolver la curva de precios de productos FBA de terceros. |
showPriceFbm | integer | opcional | Establecer a `1` para devolver la curva de precios de los nuevos productos FBM de terceros. |
showPriceCoupon | integer | opcional | Establecer a `1` Devuelve la curva de precio de Buy Box post-coupon. |
showBsrMain | integer | opcional | Establecer a `1` para devolver la clase grande de curvas BSR. |
showSellerCount | integer | opcional | Establecer a `1` devolver la curva de número del vendedor. |
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 (20 campos)
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
asin | string | opcional | ASIN。 |
buyboxPrice | array | opcional | Comprar Precio de la caja; los elementos contienen `time` (hora) y `value` (Precio del cuadro de compras). |
price | array | opcional | El precio más bajo del nuevo producto en el mercado; elementos incluyen `time` y `value`. |
priceList | array | opcional | Precio de strikethrough; los elementos contienen `time` y `value`. |
priceDeal | array | opcional | Precio de venta; los elementos contienen `time` y `value`. |
pricePrime | array | opcional | Precio primario; los elementos contienen `time` y `value`. |
priceFba | array | opcional | Precio FBA; los elementos contienen `time` y `value`. |
priceFbm | array | opcional | Precio de FBM; los elementos contienen `time` y `value`. |
priceCoupon | array | opcional | Precio del cupón; los elementos contienen `time` y `value`. |
bsrMain | array | opcional | Categoría BSR; cada elemento contiene `categoryName` (nombre de la categoría) y `points` (punto de la serie temporal). |
bsrSub | array | opcional | Pequeña clase BSR; cada elemento contiene `categoryName` (nombre de la categoría) y `points` (punto de la serie temporal). |
sellerCount | array | opcional | Número de vendedores; los elementos contienen `time` y `value`. |
rating | array | opcional | Clasificación;los elementos contienen `time` y `value`. |
ratingCount | array | opcional | Número de puntuación; los elementos contienen `time` y `value`. |
monthlySold | array | opcional | Ventas de subody; elementos contienen `time` y `value`. |
costToken | integer | opcional | Consumir token. |
time | — | opcional | Tiempo; el tipo específico estará sujeto al archivo fuente o a la documentación oficial anterior. |
value | — | opcional | El valor del indicador correspondiente al punto de referencia; el tipo específico estará sujeto al archivo fuente o a la documentación oficial anterior. |
categoryName | — | opcional | Nombre de la categoría; el tipo específico estará sujeto al archivo fuente o a la documentación oficial anterior. |
points | — | opcional | Esta categoría es un punto de la serie temporal BSR, y los elementos incluyen `time` y `value`; el tipo específico está sujeto al archivo fuente o al documento oficial anterior. |
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.