https://api.nexscope.ai/ss/competitor-lookupEjecutar 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/ss/competitor-lookup |
| Autenticación | Bearer API key |
| Content-Type | application/json |
Parámetros de la solicitud
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
marketplace | string | opcional | Códigos de sitio del Amazonas: `US`, `UK`, `DE`, `FR`, `JP`, `CA`, `IT`, `ES`, `MX`, `AU`, `TR`, `IN` Ejemplo: US |
keyword | string | opcional | Buscar palabras clave, se recomienda utilizar el idioma del sitio objetivo |
asinList | string | opcional | ASIN, múltiples ASINs separados por comas inglesas, hasta 40; formato: `^[A-Z0-9]+(,[A-Z0-9]+){0,39}$` |
sellerName | string | opcional | Filtro de nombre del vendedor |
brand | string | opcional | Filtro de nombre de marca |
nodeLabel | string | opcional | Nombre de categoría Amazon, soporta nombres de categorías de varios niveles, y los niveles están separados por colon Inglés `:` |
nodeIdPath | string | opcional | Ruta de identificación de categoría de Amazon |
matchType | integer | opcional | Método de coincidencia: `1` correspondencia de frases, `2` - ¿Qué? `3` correspondencia precisa Ejemplo: 1 |
showVariation | string | opcional | Consultar la variante: `Y` Sí, `N` no Ejemplo: N |
dataSnapshotMonth | string | opcional | `nearly` representa los últimos 30 días de datos en tiempo real; las instantáneas históricas también pueden ser consultadas en el `yyyyMM` formato, como `202412` Ejemplo: nearly |
page | integer | opcional | Número de página, a partir de 1 Ejemplo: 1 |
size | integer | opcional | Número de artículos por página, devolver 10–100 datos Ejemplo: 50 |
order | object | opcional | Configuración de clasificación, los campos se muestran en la tabla siguiente |
field | string | obligatorio | Campos de clasificación: `total_units`, `total_amount`, `bsr_rank`, `price`, `rating`, `reviews`, `profit`, `reviews_rate`, `available_date`, `questions`, `total_units_growth`, `total_amount_growth`, `reviews_increasement`, `bsr_rank_cv`, `bsr_rank_cr`, `amz_unit` Ejemplo: total_units |
desc | string | obligatorio | Dirección de clasificación: `true` orden descendente, `false` orden ascendente Ejemplo: true |
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 (64 campos)
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
total | integer | opcional | Número total de resultados coincidentes |
sourceType | string | opcional | Tipo de fuente, como `amazon` |
message | string | opcional | Mensaje de ejecución o descripción de error |
type | string | opcional | estilo de renderizado |
nodeLabel | string | opcional | Nombre de la categoría eco |
columns | array | opcional | Definiciones de columna renderizadas |
products | array | opcional | Lista de productos competidores |
costToken | integer | opcional | Consumir token |
asin | string | opcional | Producto ASIN |
title | string | opcional | Título del producto |
price | number | opcional | Precio actual |
primePrice | number | opcional | Precio principal |
averagePrice | number | opcional | Precio medio |
currency | string | opcional | Moneda |
monthlySalesUnits | integer | opcional | Volumen de ventas mensual (número de piezas) |
monthlySalesRevenue | number | opcional | ventas mensuales |
monthlySalesUnitsGrowthRate | number | opcional | tasa mensual de crecimiento de las ventas |
bsr | integer | opcional | Clasificación BSR |
bsrGrowthRate | number | opcional | Tasa de crecimiento de la RSE |
bsrGrowthCount | integer | opcional | Número de crecimiento de la RSE |
rating | number | opcional | Calificación |
ratings | integer | opcional | Número de calificación |
ratingsGrowth | integer | opcional | Número de nuevas valoraciones por mes |
ratingsRate | number | opcional | Tasa de revisión |
brand | string | opcional | marca |
brandUrl | string | opcional | Marca URL |
sellerName | string | opcional | BuyBox vendedor nombre |
sellerId | string | opcional | ID del vendedor de BuyBox |
sellerNation | string | opcional | BuyBox vendedor nacionalidad |
sellerNum | integer | opcional | Número de vendedores |
fulfillment | string | opcional | Método de entrega: `AMZ`, `FBA`, `FBM` |
availableDate | string | opcional | Tiempo de lanzamiento (formato de la fecha) |
availableDateString | string | opcional | Fecha de lanzamiento (formato en cadena) |
profit | number | opcional | Margen de beneficio bruto |
fba | number | opcional | FBA naviera |
deliveryPrice | number | opcional | Tarifa de envío del vendedor |
imageUrl | string | opcional | Imagen del producto URL |
parent | string | opcional | Padre ASIN |
variationNum | integer | opcional | número de variantes |
variant30DayUnits | integer | opcional | Volumen mensual de ventas de cuerpos de hijas (número de piezas) |
variant30DayRevenue | number | opcional | Ventas mensuales subsidiarias |
variant30DayUpdatedAt | string | opcional | Tiempo de actualización de los datos de los niños (momento) |
amzUnitDateString | string | opcional | Fecha de actualización de las ventas del subgrupo |
listingQualityScore | number | opcional | Listado de puntuación de calidad |
nodeLabelPath | string | opcional | Ruta de categoría |
nodeIdPath | string | opcional | Ruta del ID del nodo |
nodeId | integer | opcional | ID del nodo |
dimension | string | opcional | Tamaño del producto |
dimensionsType | string | opcional | tipo de tamaño |
weight | string | opcional | Peso del producto |
packageDimensions | string | opcional | Tamaño del envase |
packageDimensionType | string | opcional | Tamaño del envase |
packageWeight | string | opcional | Peso del envase |
sku | string | opcional | SKU |
keyword | string | opcional | palabras clave coincidentes |
dataSnapshotMonth | string | opcional | Mes de consulta de datos |
sourceType | string | opcional | Tipo de fuente |
badgeBestSeller | string | opcional | Logotipo del mejor vendedor (Y/N) |
badgeAmazonChoice | string | opcional | Logotipo de la opción de Amazon (Y/N) |
badgeNewRelease | string | opcional | Logotipo de nueva versión (Y/N) |
badgeEbc | string | opcional | Identificación de la página A+ (Y/N) |
badgeVideo | string | opcional | Logotipo de introducción de vídeo (Y/N) |
badge | object | opcional | Objeto de datos de identidad, incluidos `bestSeller`, `amazonChoice`, `newRelease`, `ebc`, `video` (Todos Y/N cuerdas) |
subcategories | array | opcional | Clasificación de subcategorías, cada una de ellas con `code`, `rank`, `label` |
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.