https://api.nexscope.ai/jm/productDiscoveryEjecutar 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/jm/productDiscovery |
| Autenticación | Bearer API key |
| Content-Type | application/json |
Parámetros de la solicitud
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
keyword | string | obligatorio | Palabras clave (requeridas, y según el país seleccionado, traducir las palabras clave al idioma del país correspondiente) |
countryCode | string | opcional | Para los países, utilice la abreviatura del país. `US`. Valores opcionales: `US`, `JP`, `DE` |
priceMin | number | opcional | precio del producto más bajo |
priceMax | number | opcional | Precio máximo del producto |
totalReviewsMin | integer | opcional | Número mínimo de comentarios |
totalReviewsMax | integer | opcional | Mayor número de comentarios |
customerRatingMin | number | opcional | calificación más baja |
customerRatingMax | number | opcional | la calificación más alta |
clickConversionRateMin | number | opcional | Mínimo clic-a-compra tasa de conversión, el rango de valor es 0-1, 0.1 significa 10% |
clickConversionRateMax | number | opcional | La tasa de conversión más alta de clic a compra, el rango de valor es 0-1, 0.1 significa 10% |
clickConversionRateCompositeMin | number | opcional | Mínimo índice de conversión integral, el rango de valor es 0-1, 0.1 significa 10% |
clickConversionRateCompositeMax | number | opcional | La tasa de conversión más alta, el rango de valor es 0-1, 0.1 significa 10% |
clickCountT7Min | integer | opcional | Mínimo clic semanal |
clickCountT7Max | integer | opcional | Mayor número de clics por semana |
clickCountT30Min | integer | opcional | Mínimo clics mensuales |
clickCountT30Max | integer | opcional | Mayores clics mensuales |
clickCountGrowthT7Min | number | opcional | Mínimo de crecimiento semanal de clics, el rango de valor es 0-1, 0.1 significa 10% |
clickCountGrowthT7Max | number | opcional | El mayor crecimiento semanal de clics, el rango de valor es 0-1, 0.1 significa 10% |
clickCountGrowthT30Min | number | opcional | Mínimo índice de crecimiento mensual de clics, el rango de valor es 0-1, 0.1 significa 10% |
clickCountGrowthT30Max | number | opcional | El mayor crecimiento mensual de clics, el rango de valor es 0-1, 0.1 significa 10% |
salesVolumeT360Min | integer | opcional | Volumen mínimo anual de ventas |
salesVolumeT360Max | integer | opcional | volumen de ventas anuales más alto |
grossProfitMarginMin | number | opcional | Margen de beneficio bruto mínimo |
grossProfitMarginMax | number | opcional | Margen de beneficio bruto más alto |
fbaFeeMin | number | opcional | Comisión mínima de la FBA |
fbaFeeMax | number | opcional | Comisión FBA más alta |
launchDateMin | string | opcional | Tiempo mínimo de estanterías, el formato es: `yyyyMMdd000000` |
launchDateMax | string | opcional | El tiempo máximo de estanterías, el formato es: `yyyyMMdd000000` |
nicheCountMin | integer | opcional | Número mínimo de segmentos |
nicheCountMax | integer | opcional | Mayor número de segmentos de mercado |
sellerCountry | string | opcional | Código de país y región del vendedor. Si se hacen múltiples selecciones, sepárelas con comas, como: `CN,US` |
sortField | string | opcional | Ordenar campo. Por defecto `purchasedClicksT360`. Valores opcionales: `totalReviews` (número total de comentarios), `price` (precio), `launchDate` (hora de inclusión en la lista), `clickCountT7` (clics de 7 días), `clickCountT30` (30 días de clics), `clickCountT90` (clics de 90 días), `clickConversionRate` (tasa de conversión de clic en la compra), `clickConversionRateComposite` (tipo de conversión de clic en la compra), `customerRating` (rating), `purchasedClicksT360` volumen de compra de 360 días, `clickCountGrowthT7` (tasa de crecimiento semanal del clic), `clickCountGrowthT30` (con clics mensuales en la tasa de crecimiento), `currentPrice` (precio actual), `fbaFee` (Comisión de la FBA), `shippingFee` (cargueros FBA), `gpm` (margen de beneficio bruto) |
sortType | string | opcional | Ordenar por. Por defecto `desc`. Valores opcionales: `desc` (orden descendente), `asc` (Orden ascendente) |
page | integer | opcional | Número de página. Por defecto `1` |
pageSize | integer | opcional | Cantidad por página (10-100). Predeterminado `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 (29 campos)
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
total | integer | opcional | Total |
sourceType | string | opcional | Tipo de fuente: `amazon` |
type | string | opcional | Estilo de representación |
title | string | opcional | Título |
costToken | integer | opcional | Consumir token |
columns | array | opcional | Columnas renderizadas |
products | array | opcional | Lista de productos (véanse más detalles más adelante) |
asin | string | opcional | Producto amazónico ASIN |
parentAsin | string | opcional | Padre del producto Amazon ASIN |
title | string | opcional | Título del producto |
brand | string | opcional | marca |
price | number | opcional | precio |
imageUrl | string | opcional | Imagen principal del producto |
productImageUrls | array | opcional | Lista de enlaces de imágenes de productos |
asinUrl | string | opcional | ASIN enlace |
ratings | integer | opcional | Número de comentarios |
availableDate | string | opcional | Tiempo de liberación (momento) |
availableDateString | string | opcional | Fecha de lanzamiento (cadena) |
categoryNames | array | opcional | Información sobre la categoría |
marketplaceId | string | opcional | ID del sitio |
clickCountT7 | integer | opcional | Clicks por semana |
clickCountT30 | integer | opcional | Clicks por mes |
clickCountT90 | integer | opcional | Aciertos trimestrales |
clickConversionRate | number | opcional | Haga clic en la tasa de conversión de la compra |
clickConversionRateComposite | number | opcional | Tipo de conversión global |
grossProfitMargin | number | opcional | Margen de beneficio bruto |
fbaFee | number | opcional | Comisión amazónica |
shippingFee | number | opcional | Flete FBA |
sourceType | string | opcional | Tipo de fuente: `amazon` |
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.