https://api.nexscope.ai/et/listNewProductRankEjecutar 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/et/listNewProductRank |
| Autenticación | Bearer API key |
| Content-Type | application/json |
Parámetros de la solicitud
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
date | string | obligatorio | Fecha en el formato `YYYY-MM-DD` |
region | string | opcional | Región, por defecto `US`. Valores opcionales: Estados Unidos (Estados Unidos), ID (Indonesia), TH (Tailandia), PH (Filipinas), MY (Malasia), VN (Vietnam), GB (Reino Unido), MX (México), SG (Singapur), SA (Arabia Saudita), BR (Brasil), ES (España), JP (Japón), DE (Alemania), IT (Italia), FR (Francia) Ejemplo: US |
pageNum | integer | opcional | Número de página de la paginación, predeterminado `1` Ejemplo: 1 |
pageSize | integer | opcional | Número de elementos por página, por defecto `50` Ejemplo: 50 |
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 (28 campos)
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
total | integer | opcional | Número de registros |
products | array | opcional | Lista de productos más reciente (ver objeto del producto más abajo) |
columns | array | opcional | Columnas renderizadas |
type | string | opcional | Estilo de representación |
costToken | integer | opcional | Consumir token |
title | string | opcional | Nombre del producto |
asin | string | opcional | ID del producto |
region | string | opcional | código de área |
price | number | opcional | Precio medio de la SPU |
minPrice | number | opcional | precio más bajo |
maxPrice | number | opcional | precio más alto |
currency | string | opcional | Moneda |
totalSaleCnt | integer | opcional | ventas totales |
totalSale30dCnt | integer | opcional | Volumen de ventas en los últimos 30 días |
totalSaleGmvAmt | number | opcional | ventas totales |
totalSaleGmv30dAmt | number | opcional | Ventas en los últimos 30 días |
salesTrendFlagText | string | opcional | Indicador de tendencia de ventas, 0=estable, 1=aumento, 2=declinación |
totalVideoCnt | integer | opcional | Número total de vídeos |
totalLiveCnt | integer | opcional | Número total de emisiones en directo |
totalIflCnt | integer | opcional | Número total de personas |
productCommissionRate | number | opcional | Relación de la comisión de productos |
productRating | number | opcional | calificación del producto |
reviewCount | integer | opcional | Número de comentarios |
availableDate | string (date) | opcional | Primera fecha de arrastre |
categoryId | string | opcional | ID de categoría de producto |
imageUrl | string | opcional | Imágenes del producto |
productImageUrls | array | opcional | Imagen del producto URL lista |
sourceType | string | opcional | Fuente del producto |
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.