https://api.nexscope.ai/jm/pageAsinsByAsinEjecutar 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/pageAsinsByAsin |
| Autenticación | Bearer API key |
| Content-Type | application/json |
Parámetros de la solicitud
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
asin | string | obligatorio | Referencia ASIN se utiliza para consultar la lista de productos competidores pertenecientes al mismo segmento del mercado (Niche) que el ASIN. La longitud máxima es de 1000 caracteres. |
countryCode | string | opcional | Código del país, valores opcionales: `US` (Estados Unidos), `JP` (Japón), `DE` (Alemania) Ejemplo: US |
page | integer | opcional | Número de página (a partir de 1) Ejemplo: 1 |
pageSize | integer | opcional | Número de devoluciones por página (10-100) Ejemplo: 50 |
sortField | string | opcional | Campo de clasificación (ver opciones de clasificación más abajo) Ejemplo: purchasedClicksT360 |
sortType | string | opcional | Ordenar por: `desc` (descendiendo) o `asc` (ascendente) Ejemplo: desc |
priceMin | number | opcional | precio del producto más bajo |
priceMax | number | opcional | Precio máximo del producto |
fbaFeeMin | number | opcional | Comisión mínima de la FBA |
fbaFeeMax | number | opcional | Comisión FBA más alta |
grossProfitMarginMin | number | opcional | Margen de beneficio bruto mínimo |
grossProfitMarginMax | number | opcional | Margen de beneficio bruto más alto |
totalReviewsMin | integer | opcional | Número mínimo de comentarios |
totalReviewsMax | integer | opcional | Número máximo de comentarios |
customerRatingMin | number | opcional | Rango mínimo de valor 0,0-5,0 |
customerRatingMax | number | opcional | Valoración más alta, rango de valor 0,0-5,0 |
clickCountT7Min | integer | opcional | Mínimo clic semanal |
clickCountT7Max | integer | opcional | Mayor número de clics por semana |
clickCountGrowthT7Min | number | opcional | Tasa de crecimiento semanal mínima de clics, rango de valor 0-1, por ejemplo, 0.1 significa 10% |
clickCountGrowthT7Max | number | opcional | La tasa de crecimiento de clics semanales más alta, el rango de valor es 0-1, por ejemplo, 0.1 significa 10% |
clickConversionRateMin | number | opcional | Tasa mínima de conversión de clics, rango de valor 0-1, por ejemplo, 0.1 significa 10% |
clickConversionRateMax | number | opcional | La tasa de conversión más alta, el rango de valor es 0-1, por ejemplo, 0.1 significa 10% |
clickCountT30Min | integer | opcional | Mínimo clics mensuales |
clickCountT30Max | integer | opcional | Mayores clics mensuales |
clickCountGrowthT30Min | number | opcional | Tasa mínima mensual de crecimiento de clics, rango de valor 0-1, por ejemplo, 0.1 significa 10% |
clickCountGrowthT30Max | number | opcional | La tasa de crecimiento de clics más alta mensual, el rango de valor es 0-1, por ejemplo, 0.1 significa 10% |
clickConversionRateCompositeMin | number | opcional | Mínimo índice de conversión de clics completo, rango de valor 0-1, por ejemplo, 0.1 significa 10% |
clickConversionRateCompositeMax | number | opcional | La tasa de conversión de clics más alta, el rango de valor es 0-1, por ejemplo, 0.1 significa 10% |
salesVolumeT360Min | integer | opcional | Volumen mínimo anual de ventas |
salesVolumeT360Max | integer | opcional | Mayores ventas anuales |
launchDateMin | string | opcional | El tiempo de lanzamiento más temprano, en el formato de yyyyMMdd000000 |
launchDateMax | string | opcional | La última fecha de lanzamiento, en el formato de yyyyMMdd000000 |
nicheCountMin | integer | opcional | Número mínimo de segmentos |
nicheCountMax | integer | opcional | Número máximo de segmentos de mercado |
sellerCountry | string | opcional | El código del país del país del vendedor. Si selecciona varios países, sepárelos con comas inglesas, como: CN, US |
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 (47 campos)
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
total | integer | opcional | Número total de registros |
pages | integer | opcional | Total páginas |
page | integer | opcional | Página actual |
pageSize | integer | opcional | tamaño de página |
data | array | opcional | ASIN lista de productos (ver campos de objeto del producto abajo) |
columns | array | opcional | Columnas renderizadas |
type | string | opcional | Estilo de representación |
costToken | integer | opcional | Consumir token |
asin | string | opcional | Producto Amazon ASIN |
parentAsin | string | opcional | Padre del producto Amazon ASIN |
title | string | opcional | Título del producto |
brand | string | opcional | marca |
price | number | opcional | precio |
currentPrice | number | opcional | Precio actual |
currency | string | opcional | Moneda |
customerRating | number | opcional | Calificación |
totalReviews | integer | opcional | Número de comentarios |
launchDate | string | opcional | Plazo de validez |
link | string | opcional | ASIN enlace |
imagesUrl | string | opcional | Imagen principal del producto |
sellerName | string | opcional | Nombre del vendedor |
sellerId | string | opcional | ID del vendedor |
fbaFee | number | opcional | Comisión de la FBA |
shippingFee | number | opcional | Flete FBA |
gpm | number | opcional | Margen de beneficio bruto |
clickConversionRate | number | opcional | Tasa de conversión de clic (original de 7 días de clic de la tasa de conversión) |
clickConversionRateComposite | number | opcional | Tasa de conversión completa de clics |
clickConversionRateType | string | opcional | Tipo de cálculo de la tasa de conversión |
clickConversionRateCompositeType | string | opcional | Tipo de cálculo global del tipo de conversión |
clickCountT7 | integer | opcional | Hace clic en 7 días |
clickCountT30 | integer | opcional | Clicks en 30 días |
clickCountT90 | integer | opcional | Clicks en 90 días |
clickCountGrowthT7 | number | opcional | Tasa de crecimiento de clics semanales |
clickCountGrowthT30 | number | opcional | Tasa de crecimiento mensual de clics |
purchasedClicksT360 | integer | opcional | 360 días de compra clic |
salesVolumeT360 | integer | opcional | ventas anuales |
nicheCount | integer | opcional | Número de segmentos de mercado a los que pertenece |
sameNicheTitle | string | opcional | El mismo segmento del mercado (Niche) |
involvedNum | integer | opcional | El número de palabras clave involucradas |
involvedFrequency | integer | opcional | Frecuencia de las palabras clave implicadas |
categoryNames | array | opcional | Información sobre la categoría |
hasMetric | boolean | opcional | Identifica si existen indicadores |
searchValueType | string | opcional | Tipo de búsqueda: exacta (comparación exacta), sameNiche (pertenece al mismo segmento del mercado que la referencia ASIN), categoría (categoría) |
niches | array | opcional | los tres segmentos principales del mercado, incluidos: nicheId, nicheTitle, demanda (puntuación del mercado), imagen, marketplaceId |
bestSellersRanking | array | opcional | Clasificación de la lista de los más vendidos, incluyendo: rango (rango), categoría (nombre de la categoría) |
trends | array | opcional | datos sobre la tendencia de 90 días, incluidos: día (fecha), clickCountT7 (clips semanales), reviewCount (número de revisiones), reviewRating (rating), bestSellerRanking (rango BSR), averagePriceT7 (precio medio semanal), totalOfferDepthT7 (nuevas ofertas en 7 días) |
lastUpdateTime | string | opcional | Última actualización |
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.