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` |
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 | sf business return code, `"1"` indicates success |
msg | string | opcional | news |
total | integer | opcional | The actual amount of data returned this time |
data | array | opcional | keyword data array |
columns | array | opcional | render column |
type | string | opcional | rendering style |
title | string | opcional | Title |
isParentAsin | boolean | opcional | Is it a parent ASIN? |
hasVaiants | boolean | opcional | Are there any variants? |
abaCreateDateWeek | string | opcional | The latest weekly ABA data corresponds to the weekly time |
costTime | integer | opcional | Time consuming (ms) |
costToken | integer | opcional | Consume token |
keyword | string | opcional | keywords |
translateKeyword | string | opcional | Site localization translation |
asin | string | opcional | ASIN del producto |
productNaturalRank | integer | opcional | Natural search ranking |
naturalRankDisplay | string | opcional | Natural ranking display text |
productAdRank | integer | opcional | SP Ad Rank |
adRankDisplay | string | opcional | Ad rank display text |
weeklySearchVolume | integer | opcional | Estimated search volume per week |
keywordPopularityRank | integer | opcional | Keyword popularity ranking. The smaller the value, the greater the search volume. |
totalSearchResultProductCount | integer | opcional | Total number of search results items |
trafficShare | number | opcional | The proportion of traffic this keyword brings to ASIN, 1 means 100% |
naturalTrafficShare | number | opcional | Natural traffic score proportion |
paidTrafficShare | number | opcional | Proportion of paid advertising traffic score (SP+SB+SBV+recommended advertising) |
naturalTrafficScore | number | opcional | Natural Search Exposure Score |
sponsoredProductsScore | number | opcional | SP regular bit score |
brandAdScore | number | opcional | SB Brand Advertising Score (Regular + Video) |
videoAdScore | number | opcional | SBV Video Ad Score |
sponsoredRecommendationScore | number | opcional | SP recommendation total score |
sponsoredRecommendationBreakdown | array | opcional | Recommendation bit details, each item is `{title, score, scoreRatio}` |
clickConcentrationShare | number | opcional | ABA TOP3 click concentration, not conversion rate |
clickToPurchaseConversionRate | number | opcional | Click-to-purchase conversion rate (`purchaseQty / clickQty`) |
displayPositionTypes | array | opcional | Placement: `natural`, `ac`, `sp`, `top`, `bottom`, `er`, `vedio`, `tr`, `trfob` |
trafficCharacteristicMarkers | array | opcional | Traffic tags: `isMainKw`, `isAccurateKw`, `isAccurateAboveKw`, `isAccurateTailKw` |
conversionPerformanceMarkers | array | opcional | Conversion tags: `isPurchaseKw`, `isQualityKw`, `isStableKw`, `isLossKw`, `isInvalidKw` |
lastNaturalRankTime | string | opcional | The most recent effective natural ranking time |
lastAdRankTime | string | opcional | Last effective SP ad ranking time |
periodEndDate | string | opcional | End date of this cycle |
updateTime | string | opcional | Keyword data update time |
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 una clave API ausente o no válida (code 11209, incluida una copia incompleta o dañada) o una sesión web caducada (code 12001), 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.