https://api.nexscope.ai/js/product-database/queryEjecutar 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/js/product-database/query |
| Autenticación | Bearer API key |
| Content-Type | application/json |
Parámetros de la solicitud
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
marketplace | string | obligatorio | Código de mercado objetivo. Valores opcionales: `us`, `uk`, `de`, `in`, `ca`, `fr`, `it`, `es`, `mx`, `jp` Ejemplo: us |
includeKeywords | string | opcional | Título/ASIN contiene palabras clave, comas separadas, hasta 100 elementos, cada elemento puede ser de hasta 50 caracteres |
excludeKeywords | string | opcional | Título/ASIN palabras clave excluidas, comas separadas, hasta 100 elementos, cada elemento puede ser de hasta 50 caracteres |
categories | string | opcional | Los nombres de las categorías principales, separados por comas, deben coincidir con los nombres de las categorías estándar del sitio correspondiente. Ejemplos de sitios de los EE.UU.: Electrodomésticos, Artes Artesanías y Costura, Automoción, Bebé, Belleza y Cuidado Personal, Libros, CDs y Vinilo, Celulares y Accesorios, Zapatos de Ropa y Joyas, Coleccionismo y Arte, Computadoras, Música Digital, Electrónica, Jardín y Outdoor, Alimentos de la Tienda y Cuidados del Bebé, Artesanía, Salud, Hogar y Cocina, Industrial y Científica, Kindle Store, Cocina y Comedor, Películas y TV, Instrumentos Musicales, Productos de Office, Suministros de Mascotas, Deportes y Exteriores, Herramientas y Mejoras del Hogar, Juguetes y Juegos de Video, etc.; otros sitios tienen nombres de categoría locales correspondientes |
minPrice | number | opcional | precio más bajo |
maxPrice | number | opcional | precio más alto |
minSales | integer | opcional | Ventas mensuales mínimas |
maxSales | integer | opcional | Mayores ventas mensuales |
minRevenue | number | opcional | ingresos mínimos mensuales |
maxRevenue | number | opcional | ingresos mensuales más altos |
minReviews | integer | opcional | Número mínimo de comentarios |
maxReviews | integer | opcional | Mayor número de comentarios |
minRating | number | opcional | Rating más bajo (1,0-5,0) |
maxRating | number | opcional | Máxima calificación (1,0-5,0) |
minWeight | number | opcional | Peso mínimo (lbs) |
maxWeight | number | opcional | Peso máximo (lbs) |
minRank | integer | opcional | Rango de RSE más bajo |
maxRank | integer | opcional | El más alto rango de BSR |
minLqs | integer | opcional | Puntuación mínima de LQS (1-10) |
maxLqs | integer | opcional | Mayor puntuación LQS (1-10) |
minSellers | integer | opcional | Número mínimo de vendedores |
maxSellers | integer | opcional | Número máximo de vendedores |
minNet | number | opcional | beneficio neto mínimo |
maxNet | number | opcional | mayor beneficio neto |
sellerTypes | string | opcional | Tipos de vendedores, separados por comas. Valores opcionales: `amz` (Amazon auto-operado), `fba`, `fbm` |
productTiers | string | opcional | Jerarquía del tamaño del producto, separada por comas. Valores opcionales: `oversize`, `standard` |
excludeTopBrands | boolean | opcional | Si se debe excluir las marcas principales |
excludeUnavailableProducts | boolean | opcional | Si se excluyen los artículos no comprables |
minUpdatedAt | string | opcional | Fecha de inicio de la actualización de los datos (AAAA-MM-DD) |
maxUpdatedAt | string | opcional | Fecha límite de actualización de los datos (AAAA-MM-DD) |
needCount | integer | opcional | El número total de resultados a devolver, la búsqueda automática dentro de la API |
sort | string | opcional | Ordenar campo. Valores permitidos: `name`, `-name`, `category`, `-category`, `revenue`, `-revenue`, `sales`, `-sales`, `price`, `-price`, `rank`, `-rank`, `reviews`, `-reviews`, `lqs`, `-lqs`, `sellers`, `-sellers`, `-`. Un líder `-` tipo en orden descendente. Ejemplo: name |
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 (41 campos)
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
costToken | integer | opcional | Número de fichas consumidas |
productDatabaseList | array | opcional | Lista de datos sobre productos |
id | string | opcional | Identificador único del producto |
title | string | opcional | Título del producto |
brand | string | opcional | marca |
category | string | opcional | Categoría principal |
breadcrumbPath | string | opcional | Ruta completa de clasificación |
price | number | opcional | Precio de venta actual (USD) |
approximate30DayUnitsSold | integer | opcional | Ventas estimadas en los últimos 30 días |
approximate30DayRevenue | number | opcional | Ingresos estimados para los últimos 30 días (USD) |
productRank | integer | opcional | Clasificación BSR |
reviews | integer | opcional | Número total de comentarios |
rating | number | opcional | Promedio (1,0-5,0) |
listingQualityScore | integer | opcional | Puntuación de calidad de la lista (LQS, 1-10) |
numberOfSellers | integer | opcional | Número de vendedores en venta |
sellerType | string | opcional | Tipo de vendedor (amz/fba/fbm) |
imageUrl | string | opcional | Imagen principal del producto URL |
dateFirstAvailable | string | opcional | Fecha de la primera puesta en estantes |
weightValue | number | opcional | Peso del producto |
weightUnit | string | opcional | unidad de peso |
lengthValue | number | opcional | longitud |
widthValue | number | opcional | Ancho |
heightValue | number | opcional | altura |
dimensionsUnit | string | opcional | Unidad dimensional |
parentAsin | string | opcional | Padre ASIN |
isParent | boolean | opcional | ¿Es el cuerpo de los padres? |
isVariant | boolean | opcional | ¿Es una variante? |
isStandalone | boolean | opcional | ¿Es un producto independiente? |
isAvailable | boolean | opcional | disponible para la compra |
buyBoxOwner | string | opcional | Buy Box sostiene el nombre del vendedor |
buyBoxOwnerSellerId | string | opcional | Buy Box contiene ID del vendedor |
updatedAt | string | opcional | Tiempo de actualización de los datos |
feeBreakdown | object | opcional | Detalles de la tarifa: `fbaFee` (tasa FBA), `referralFee` (tasa de remisión), `variableClosingFee` (tasa variable de liquidación), `totalFees` (total de la tasa) |
subcategoryRanks | array | opcional | Lista de clasificación de la subcategoría BSR, cada una de las cuales contiene: `subcategory`, `rank`, `id` |
type | string | opcional | Tipo de recurso |
variants | array | opcional | Lista de variaciones |
upcList | array | opcional | Lista de códigos de la UPC |
eanList | array | opcional | Lista de códigos EAN |
isbnList | array | opcional | Lista de códigos ISBN |
gtinList | array | opcional | Lista de códigos GTIN |
dateFirstAvailableIsEstimated | boolean | opcional | ¿Es la fecha de lanzamiento un estimado? |
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.