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 | Total number of items |
marketplace | string | opcional | market code |
asin | string | opcional | Query ASIN |
data | array | opcional | Traffic word list (corresponding to third-party `data.items`) |
summaryList | array | opcional | High frequency word summary list |
columns | array | opcional | Column definition |
costToken | integer | opcional | Consume token |
type | string | opcional | rendering style |
total | integer | opcional | Total times |
keywords | string | opcional | word |
keyword | string | opcional | keywords |
keywordCn | string | opcional | Keywords Chinese translation |
trafficKeywordType | string | opcional | Traffic proportion type |
conversionKeywordType | string | opcional | Traffic conversion type |
badges | array | opcional | Exposure position (traffic word type) |
rankPosition | object | opcional | Natural ranking position information, see ranking object for structure |
adPosition | object | opcional | Ad ranking information, the structure is the same as the ranking object |
searches | integer | opcional | Monthly searches |
searchesRank | integer | opcional | Weekly search volume ranking |
searchesRankTimeFrom | integer | opcional | Weekly search volume ranking time range from |
searchesRankTimeTo | integer | opcional | Weekly search volume ranking time range ends |
purchases | integer | opcional | Monthly purchase volume |
purchaseRate | number | opcional | purchase rate |
products | integer | opcional | Number of items |
supplyDemandRatio | number | opcional | Supply and demand ratio |
trafficPercentage | number | opcional | Traffic proportion |
naturalRatio | number | opcional | Traffic distribution-natural proportion |
adRatio | number | opcional | Traffic distribution-advertising proportion |
calculatedWeeklySearches | number | opcional | Estimated weekly exposure |
impressions | integer | opcional | Impression volume |
clicks | integer | opcional | Clicks |
bid | number | opcional | PPC bidding |
bidMin | number | opcional | PPC bid minimum |
bidMax | number | opcional | PPC bid cap |
latest1daysAds | integer | opcional | Number of advertising competitors in the last day |
latest7daysAds | integer | opcional | Number of advertising competitors in the last 7 days |
latest30daysAds | integer | opcional | Number of competing advertising products in the last 30 days |
sprt | number | opcional | SP correlation ratio |
monopolyClickRate | number | opcional | Monopoly click rate |
top3ClickingRate | number | opcional | Top3 click rate |
top3ConversionRate | number | opcional | Top3 conversion rate |
titleDensity | number | opcional | title density |
stats | array | opcional | High-frequency words, the elements are shown in the table below |
updatedTime | integer | opcional | Update time |
keywords | string | opcional | word |
total | integer | opcional | Total number of items |
rankPosition | object | opcional | Natural ranking position, see ranking object for structure |
adPosition | object | opcional | Ad ranking position, see ranking object for structure |
updatedTime | integer | opcional | Ranking time |
pageSize | integer | opcional | How many pieces of data per page |
index | integer | opcional | What is the current page ranking? |
page | integer | opcional | Which page |
position | integer | opcional | What is the ranking among the total results? |
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.