https://api.nexscope.ai/js/keywords/by-asinEjecutar 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/keywords/by-asin |
| 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 |
asins | string[] | obligatorio | Lista de ASINs, hasta 10 |
needCount | integer | opcional | Número total de resultados devueltos (pagación automática interna) |
includeVariants | boolean | opcional | Indica si se deben incluir palabras clave para productos de variantes |
sort | string | opcional | Campo de clasificación; valores opcionales ver la tabla de campos de clasificación debajo Ejemplo: -monthly_search_volume_exact |
minMonthlySearchVolumeExact | integer | opcional | Volumen mínimo mensual de búsqueda precisa (1-999999) |
maxMonthlySearchVolumeExact | integer | opcional | Volumen máximo mensual de búsqueda precisa (1-999999) |
minMonthlySearchVolumeBroad | integer | opcional | Volumen mínimo mensual de búsqueda amplia (1-999999) |
maxMonthlySearchVolumeBroad | integer | opcional | Volumen máximo mensual de búsqueda amplio (1-999999) |
minWordCount | integer | opcional | Número mínimo de palabras (1-99999) |
maxWordCount | integer | opcional | Número máximo de palabras (1-99999) |
minOrganicProductCount | integer | opcional | Número mínimo de resultados de búsqueda natural (1-99999) |
maxOrganicProductCount | integer | opcional | Número máximo de resultados de búsqueda natural (1-99999) |
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 (36 campos)
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
costToken | integer | opcional | Número de fichas consumidas |
keywordInfoList | array | opcional | Lista de información de palabras clave |
name | string | opcional | palabras clave |
country | string | opcional | Código del mercado |
monthlySearchVolumeExact | integer | opcional | Volumen de búsqueda mensual exacta de coincidencias |
monthlySearchVolumeBroad | integer | opcional | Volumen de búsqueda mensual de partidos amplios |
monthlyTrend | float | opcional | Evolución mes a mes (%) |
quarterlyTrend | float | opcional | Tendencia trimestral (%) |
dominantCategory | string | opcional | Principales categorías |
relevancyScore | integer | opcional | Pertinencia de las palabras clave a ASIN (0-100) |
easeOfRankingScore | integer | opcional | Facilidad de clasificación (0-100, cuanto más alto es, más fácil es clasificar) |
organicRank | integer | opcional | ASINClasificación orgánica de búsquedas |
sponsoredRank | integer | opcional | Ranking de anuncios ASIN |
overallRank | integer | opcional | Posición general de clasificación |
organicProductCount | integer | opcional | Número total de productos en los resultados de búsqueda ecológica |
sponsoredProductCount | integer | opcional | Número total de productos espaciales publicitarios |
ppcBidExact | float | opcional | Coincidencia exacta PPC recomendado puja (USD) |
ppcBidBroad | float | opcional | PPC Recomendado de la oferta de la amplia coincidencia (USD) |
spBrandAdBid | float | opcional | anuncio de marca SP Recomendado oferta (USD) |
recommendedPromotions | integer | opcional | Cantidad recomendada para los ascensos |
primaryAsin | string | opcional | El más alto ASIN para esta palabra clave |
relativeOrganicPosition | float | opcional | Consultar la posición relativa natural de clasificación de un ASIN |
relativeSponsoredPosition | float | opcional | Consultar la posición relativa de clasificación de anuncios de ASIN |
organicRankingAsinsCount | integer | opcional | Número de consultas ASINs con clasificaciones naturales |
sponsoredRankingAsinsCount | integer | opcional | Número de consultas ASINs con ranking de anuncios |
avgCompetitorOrganicRank | float | opcional | Consultar la posición orgánica media de un ASIN |
avgCompetitorSponsoredRank | float | opcional | Consultar la posición media del anuncio para un ASIN |
variationLowestOrganicRank | integer | opcional | La mejor posición orgánica entre variaciones |
variationLowestSponsoredRank | integer | opcional | Mejor posición publicitaria entre las variaciones |
competitorOrganicRank | array | opcional | Clasificación natural para cada uno ASIN, elemento `{asin, organicRank}` |
competitorSponsoredRank | array | opcional | Lista de anuncios para cada uno ASIN, elemento `{asin, sponsoredRank}` |
updatedAt | string | opcional | Fecha de la última actualización |
asin | string | opcional | ASIN |
organicRank | integer | opcional | Los ASINClasificación orgánica de búsquedas |
asin | string | opcional | ASIN |
sponsoredRank | integer | opcional | Ranking de anuncios para esto ASIN |
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.