https://api.nexscope.ai/ss/traffic/keywordEjecutar 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/traffic/keyword |
| Autenticación | Bearer API key |
| Content-Type | application/json |
Parámetros de la solicitud
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
marketplace | string | obligatorio | Sitio de mercado, ver mercado valor opcional Ejemplo: US |
asin | string | obligatorio | Producto ASIN que se comprobará de forma inversa, maxLength 1000 |
month | string | opcional | Mes histórico, formato `yyyyMM` |
page | integer | opcional | Página actual Ejemplo: 1 |
size | integer | opcional | Número de artículos por página, mínimo 1, máximo 100, máxima consulta 2000 Ejemplo: 50 |
keyword | string | opcional | Filtrado de palabras clave, maxLength 1000 |
badges | string | opcional | Posición de exposición, los valores múltiples se separan por comas, ver la enumeración de las insignias |
trafficKeywordTypes | string | opcional | Tipo de proporción de tráfico, los valores múltiples están separados por comas inglesas, ver trafficKeywordTypes enumeración |
conversionKeywordTypes | string | opcional | Tipo de conversión de tráfico, varios valores están separados por comas inglesas, véase conversionKeywordTypes enumeración |
orderField | string | opcional | Campo de pedidos, véase orderField valor opcional Ejemplo: rankPosition |
orderDesc | boolean | opcional | Ordenar en orden inverso Ejemplo: false |
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 (53 campos)
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
total | integer | opcional | Número total de artículos |
marketplace | string | opcional | Código del mercado |
asin | string | opcional | Consulta ASIN |
data | array | opcional | Lista de palabras de tráfico (correspondiente a terceros) `data.items`) |
summaryList | array | opcional | Lista de resumen de palabras de alta frecuencia |
columns | array | opcional | Definición de la columna |
costToken | integer | opcional | Consumir token |
type | string | opcional | estilo de renderizado |
total | integer | opcional | Total de veces |
keywords | string | opcional | palabra |
keyword | string | opcional | palabras clave |
keywordCn | string | opcional | Palabras clave Traducción al chino |
trafficKeywordType | string | opcional | Tipo de tráfico |
conversionKeywordType | string | opcional | Tipo de conversión del tráfico |
badges | array | opcional | Posición de exposición (tipo de palabra de tráfico) |
rankPosition | object | opcional | Información natural de posición de ranking, ver clasificación objeto para la estructura |
adPosition | object | opcional | Información de clasificación de anuncios, la estructura es la misma que el objeto de clasificación |
searches | integer | opcional | Búsquedas mensuales |
searchesRank | integer | opcional | Clasificación semanal del volumen de búsqueda |
searchesRankTimeFrom | integer | opcional | Rango de tiempo de clasificación del volumen de búsqueda semanal |
searchesRankTimeTo | integer | opcional | Termina el rango de tiempo de clasificación del volumen de búsqueda semanal |
purchases | integer | opcional | Volumen de compra mensual |
purchaseRate | number | opcional | tasa de compra |
products | integer | opcional | Número de artículos |
supplyDemandRatio | number | opcional | Relación oferta-demanda |
trafficPercentage | number | opcional | Proporción de tráfico |
naturalRatio | number | opcional | Distribución del tráfico - proporción natural |
adRatio | number | opcional | Distribución del tráfico y proporción de publicidad |
calculatedWeeklySearches | number | opcional | Exposición semanal estimada |
impressions | integer | opcional | Volumen de impresión |
clicks | integer | opcional | Clicks |
bid | number | opcional | Licitación PPC |
bidMin | number | opcional | PPC licitar mínimo |
bidMax | number | opcional | Límite máximo de pujas PPC |
latest1daysAds | integer | opcional | Número de competidores publicitarios en el último día |
latest7daysAds | integer | opcional | Número de competidores publicitarios en los últimos 7 días |
latest30daysAds | integer | opcional | Número de productos publicitarios competidores en los últimos 30 días |
sprt | number | opcional | Relación de correlación entre el SP y el SP |
monopolyClickRate | number | opcional | Tasa de clics de monopolio |
top3ClickingRate | number | opcional | Top3 click rate |
top3ConversionRate | number | opcional | Tipo de conversión superior3 |
titleDensity | number | opcional | densidad del título |
stats | array | opcional | Palabras de alta frecuencia, los elementos se muestran en la tabla siguiente |
updatedTime | integer | opcional | Hora de actualización |
keywords | string | opcional | palabra |
total | integer | opcional | Número total de artículos |
rankPosition | object | opcional | Posición natural de clasificación, ver el objeto de clasificación para la estructura |
adPosition | object | opcional | Posición de clasificación de anuncios, ver el objeto de clasificación para la estructura |
updatedTime | integer | opcional | Tiempo de clasificación |
pageSize | integer | opcional | ¿Cuántos datos hay por página? |
index | integer | opcional | ¿Cuál es la clasificación actual de la página? |
page | integer | opcional | Qué página |
position | integer | opcional | ¿Cuál es el ranking entre los resultados totales? |
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.