https://api.nexscope.ai/et/listProductEjecutar 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/listProduct |
| Autenticación | Bearer API key |
| Content-Type | application/json |
Parámetros de la solicitud
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
keyword | string | opcional | Palabras clave del producto. Escríbelas en el idioma local. Longitud máxima de 1000 caracteres. |
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 |
categoryKeywordCN | string | opcional | Clasificación del producto (por favor, introduzca chino). Longitud máxima 1000 |
minTotalSaleCnt | integer | opcional | Ventas totales (valor mínimo) |
maxTotalSaleCnt | integer | opcional | Ventas totales (máximo) |
minTotalSale30dCnt | integer | opcional | Ventas a 30 días (mínimo) |
maxTotalSale30dCnt | integer | opcional | Ventas a 30 días (máximo) |
minTotalSaleGmvAmt | string | opcional | GMV (valor mínimo) Longitud máxima 1000 |
maxTotalSaleGmvAmt | string | opcional | GMV (valor máximo). Longitud máxima 1000 |
minTotalSaleGmv30dAmt | string | opcional | GMV (30 días) (mínimo). Duración máxima 1000 |
maxTotalSaleGmv30dAmt | string | opcional | GMV (30 días) (máximo). Longitud máxima 1000 |
minSpuAvgPrice | number | opcional | Precio medio de la SPU (valor mínimo) |
maxSpuAvgPrice | number | opcional | Precio medio de la SPU (máximo) |
minProductRating | number | opcional | Clasificación del producto (valor mínimo) |
maxProductRating | number | opcional | Clasificación del producto (valor máximo) |
minReviewCount | integer | opcional | Número de revisiones de productos (valor mínimo) |
maxReviewCount | integer | opcional | Número de revisiones de productos (máximo) |
minProductCommissionRate | number | opcional | Cociente de comisión de producto (valor mínimo), cuando el valor de entrada es un porcentaje, se convertirá automáticamente en un decimal, por ejemplo: 5%->0,05 |
maxProductCommissionRate | number | opcional | Cociente de comisión del producto (valor máximo), cuando el valor de entrada es un porcentaje, se convertirá automáticamente en un decimal, por ejemplo: 5%->0,05 |
minTotalIflCnt | integer | opcional | Número de personas que transportan mercancías (mínimo) |
maxTotalIflCnt | integer | opcional | Número de personas que transportan mercancías (máximo) |
minTotalVideoCnt | integer | opcional | Número de vídeos con productos (mínimo) |
maxTotalVideoCnt | integer | opcional | Número de vídeos con mercancías (valor máximo) |
minTotalViewsCnt | integer | opcional | Número de obras de teatro con bienes (valor mínimo) |
maxTotalViewsCnt | integer | opcional | Número de obras de teatro con bienes (valor máximo) |
minFirstCrawlDt | integer | opcional | Tiempo de la plataforma del producto (valor mínimo), formato YYYYMMDD (por ejemplo: 20200101 representa 2020-01-01) |
maxFirstCrawlDt | integer | opcional | Tiempo de caducidad del producto (valor máximo), formato AAAAMMDD |
saleDays | integer | opcional | El número de días que el producto ha estado a la venta, en días |
productSortField | integer | opcional | Campos de clasificación: 1= volumen total de ventas, 2= volumen total de las transacciones de mercancías, 3=Precio medio de la UPS, 4=7-volumen de ventas de días, 5=30-volumen de ventas de días, 6=7-volumen de transacción de mercancías del día, 7=30-volumen de transacción de mercancías del día. `1` Ejemplo: 1 |
sortType | integer | opcional | Método de clasificación: 0=orden ascendente (asc), 1=orden descendente (desc). `1` Ejemplo: 1 |
pageNum | integer | opcional | Número de página de la paginación. `1` Ejemplo: 1 |
pageSize | integer | opcional | Número de artículos por página. Predeterminado `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 (49 campos)
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
total | integer | opcional | Número de registros |
products | array | opcional | Lista de información sobre el producto (véanse los detalles más adelante) |
columns | array | opcional | Columnas renderizadas |
type | string | opcional | Estilo de representación |
costToken | integer | opcional | Consumir token |
productId | string | opcional | Identificación única del producto |
productName | string | opcional | Nombre del producto |
title | string | opcional | Nombre del producto |
imageUrl | string | opcional | Imagen del producto URL |
coverUrl | string | opcional | Imagen de la portada URL lista |
productImageUrls | array | opcional | Imagen del producto URL lista |
categoryName | string | opcional | Categoría de producto |
categoryIds | array | opcional | Lista de identificación de la categoría de productos |
region | string | opcional | código de área |
currency | string | opcional | Moneda |
price | number | opcional | Precio del producto |
minPrice | number | opcional | precio más bajo |
maxPrice | number | opcional | precio más alto |
spuAvgPrice | number | opcional | Precio medio de la SPU |
productRating | number | opcional | calificación del producto |
reviewCount | integer | opcional | Número de comentarios |
ratings | integer | opcional | Número de comentarios |
productCommissionRate | number | opcional | Relación de la comisión de productos |
totalSaleCnt | integer | opcional | ventas totales |
totalSale1dCnt | integer | opcional | Ventas totales en 1 día |
totalSale7dCnt | integer | opcional | Ventas totales en un plazo de 7 días |
totalSale15dCnt | integer | opcional | Ventas totales en un plazo de 15 días |
totalSale30dCnt | integer | opcional | Ventas totales en 30 días |
totalSale60dCnt | integer | opcional | Ventas totales en un plazo de 60 días |
totalSale90dCnt | integer | opcional | Ventas totales en 90 días |
monthlySalesUnits | integer | opcional | ventas mensuales |
totalSaleGmvAmt | number | opcional | ventas totales |
totalSaleGmv1dAmt | number | opcional | Ventas totales en 1 día |
totalSaleGmv7dAmt | number | opcional | Ventas totales en un plazo de 7 días |
totalSaleGmv15dAmt | number | opcional | Ventas totales en 15 días |
totalSaleGmv30dAmt | number | opcional | Ventas totales en 30 días |
totalSaleGmv60dAmt | number | opcional | Ventas totales en 60 días |
totalSaleGmv90dAmt | number | opcional | Ventas totales en 90 días |
firstCrawlDt | integer | opcional | Fecha de lanzamiento |
availableDate | string | opcional | Tiempo de liberación (momento) |
discount | string | opcional | Información sobre descuentos |
freeShippingText | string | opcional | ¿Es envío gratuito? |
offMarkText | string | opcional | ¿Hay alguna marca de descuento? |
salesFlagText | string | opcional | Cómo llevar los bienes |
salesTrendFlagText | string | opcional | etiqueta de tendencia de ventas |
isSShopText | string | opcional | ¿Es una tienda S? |
salePropsInfo | array | opcional | Información sobre los atributos de ventas (especificaciones del producto) |
sourceType | string | opcional | Fuente del producto |
asin | string | opcional | ID 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.