https://api.nexscope.ai/sf/asinKeywordsEjecutar 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/sf/asinKeywords |
| Autenticación | Bearer API key |
| Content-Type | application/json |
Parámetros de la solicitud
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
asin | string | obligatorio | ASIN código, longitud máxima 1000 caracteres; sólo uno ASIN puede ser preguntado a la vez |
country | string | opcional | Sitio: `US`, `UK`, `DE`, `CA`, `JP`, `FR`, `ES`, `IT`, `MX`, `AU`, `AE`, `BR`, `SA` Ejemplo: US |
keyword | string | opcional | Filtrado de palabras clave, longitud máxima 1000; intente utilizar el idioma del sitio objetivo |
timePieceType | string | opcional | Tipo de tiempo: `latelyDay`, `month`, `week` Ejemplo: latelyDay |
timePieceValue | string | opcional | Valor de la rebanada temporal, longitud máxima 1000; `latelyDay` sólo soportes `7` o `30`; `month` es `YYYY-MM`; `week` es la fecha de inicio de la semana `YYYY-MM-DD` Ejemplo: 7 |
conditions | string | opcional | Condiciones separadas de las comas: `nfPosition`, `isSpAd`, `isBrandAd`, `isVedioAd`, `isAC`, `isAccurateKw`, `isAccurateTailKw`, `isPurchaseKw`, `isQualityKw`, `isStableKw`, `isLossKw`, `isInvalidKw`, `isMultiVariantKw`, `isSearchVolUpKw`, `isSearchVolDownKw`; condición del ciclo: `totalPeriod.in`、`nfKeywordCnt.total`/`.in`、`adKeywordCnt.total`/`.in`、`allSpKeywordCnt.total`/`.in`、`spKeywordCnt.total`/`.in`、`recSpKeywordCnt.total`/`.in`、`allSbKeywordCnt.total`/`.in`、`sbKeywordCnt.total`/`.in`、`sbvKeywordCnt.total`/`.in` |
sortBy | string | opcional | `lastRank`、`adLastRank`、`updateTime`、`searchesRank`、`estSearchesNum` |
desc | boolean | opcional | Es el orden descendente Ejemplo: true |
pageNum | integer | opcional | Número de página Ejemplo: 1 |
pageSize | integer | opcional | Número por página, rango 10–100 Ejemplo: 100 |
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 (40 campos)
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
code | string | opcional | código de retorno de negocios sf, `"1"` indica éxito |
msg | string | opcional | noticias |
total | integer | opcional | La cantidad real de datos devueltos esta vez |
data | array | opcional | matriz de datos de palabra clave |
columns | array | opcional | render column |
type | string | opcional | estilo de renderizado |
title | string | opcional | Título |
isParentAsin | boolean | opcional | ¿Es un padre? ASIN? |
hasVaiants | boolean | opcional | ¿Hay alguna variante? |
abaCreateDateWeek | string | opcional | Los últimos datos semanales de ABA corresponden al tiempo semanal |
costTime | integer | opcional | Tiempo (ms) |
costToken | integer | opcional | Consumir token |
keyword | string | opcional | palabras clave |
translateKeyword | string | opcional | Traducción de localización del sitio |
asin | string | opcional | Producto ASIN |
productNaturalRank | integer | opcional | Clasificación de búsqueda natural |
naturalRankDisplay | string | opcional | Texto de visualización natural de ranking |
productAdRank | integer | opcional | Ranking de anuncios SP |
adRankDisplay | string | opcional | Texto de visualización de rango de anuncios |
weeklySearchVolume | integer | opcional | Volumen estimado de búsqueda por semana |
keywordPopularityRank | integer | opcional | Clasificación de popularidad de palabras clave. Cuanto más pequeño es el valor, mayor es el volumen de búsqueda. |
totalSearchResultProductCount | integer | opcional | Número total de resultados de búsqueda |
trafficShare | number | opcional | La proporción de tráfico de esta palabra clave trae a ASIN, 1 significa 100% |
naturalTrafficShare | number | opcional | Proporción de puntuación natural del tráfico |
paidTrafficShare | number | opcional | Proporción de la puntuación de tráfico de publicidad pagada (SP+SB+SBV+publicidad recomendada) |
naturalTrafficScore | number | opcional | Puntuación de exposición natural de búsqueda |
sponsoredProductsScore | number | opcional | SP puntuación de bits regular |
brandAdScore | number | opcional | SB Marca de anuncio (Regular + Video) |
videoAdScore | number | opcional | Puntuación de anuncios de vídeo SBV |
sponsoredRecommendationScore | number | opcional | Puntuación total de la recomendación SP |
sponsoredRecommendationBreakdown | array | opcional | Los detalles del bit de recomendación, cada elemento es `{title, score, scoreRatio}` |
clickConcentrationShare | number | opcional | Concentración de clics ABA TOP3, no tasa de conversión |
clickToPurchaseConversionRate | number | opcional | Tipo de conversión de clic en la compra (`purchaseQty / clickQty`) |
displayPositionTypes | array | opcional | Colocación: `natural`, `ac`, `sp`, `top`, `bottom`, `er`, `vedio`, `tr`, `trfob` |
trafficCharacteristicMarkers | array | opcional | Etiquetas de tráfico: `isMainKw`, `isAccurateKw`, `isAccurateAboveKw`, `isAccurateTailKw` |
conversionPerformanceMarkers | array | opcional | Etiquetas de conversión: `isPurchaseKw`, `isQualityKw`, `isStableKw`, `isLossKw`, `isInvalidKw` |
lastNaturalRankTime | string | opcional | El tiempo más reciente de clasificación natural eficaz |
lastAdRankTime | string | opcional | Último tiempo efectivo de clasificación de anuncios SP |
periodEndDate | string | opcional | Fecha de finalización del presente ciclo |
updateTime | string | opcional | Tiempo de actualización de datos de palabras clave |
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.