API de resumen de palabras clave de Amazon

Compara el tráfico de competidores procedente de búsquedas, anuncios y recomendaciones. Invoca la API mediante REST o MCP desde 12 créditos por llamada.

Coste12 créditos / llamada

Probar en línea

POST · https://api.nexscope.ai/sf/keywordSummaryMCP · nexscope_amazon_keyword_summary

Qué hace esta API

Comparar el tráfico de competidores de búsqueda, anuncios y recomendaciones.

Casos de uso de API de resumen de palabras clave de Amazon

Construir una lista de palabras clave

Para construir una lista de palabras clave, un analista de mercado presenta searchKeyword y país a Amazon Keyword Summary. El título devuelto, como en, productTitle ayudar a elegir términos de búsqueda de candidatos para una investigación más profunda.

Comparar las señales de la demanda de búsqueda

Un analista de mercado utiliza Amazon Keyword Resumen con searchKeyword y país para comparar las señales de la demanda de búsqueda. productTitle ayudar a comparar la demanda de palabras clave dentro del ámbito de aplicación del mercado solicitado.

Planificar un contenido o una prueba publicitaria

Para este flujo de trabajo, un analista de mercado llama a Amazon Keyword Summary con searchKeyword y país para planificar un contenido o prueba de publicidad. El resultado ayuda a seleccionar términos para un experimento de contenido o publicidad.

Preguntas frecuentes sobre API de resumen de palabras clave de Amazon

¿Qué hace el resumen de palabras clave de Amazon API ¿Volver?

Comparar tráfico de competidores de búsqueda, anuncios y recomendaciones. `title`, `asin`, `productTitle`, `productImageUrl`, `productPrice`, `customerRatingCount`, `productStarRating`, `productRatingScore`. Corresponde a los parámetros proporcionados `searchKeyword`, `country`, `asins`, `condition`, `last7d`. Los campos opcionales pueden estar ausentes; un valor que falta no debe interpretarse como un cero medido. Los valores de ejemplo ilustran la forma de respuesta, en lugar de los resultados reales de la cuenta.

¿Cuántos créditos tiene el Resumen de palabras clave de Amazon API ¿costo?

El coste documentado actualmente es 12 créditos / llamada. Es el mismo que figura en la parte superior de esta página. Si se muestra un intervalo o una estimación, el cargo final depende de la solicitud. Antes de llamar a la API, revisa los créditos disponibles y la página de precios. Consulta el registro de uso de la API para comprobar el cargo aplicado.

¿Cómo llamo al resumen de palabras clave de Amazon API desde mi aplicación o un MCP ¿Cliente?

Enviar a POST solicitud a /sf/keywordSummary con tu API como un símbolo de portador y la JSON datos de entrada API En una MCP cliente como Claude o Cursor, conectar Nexscope y llamar nexscope_amazon_keyword_summary. Utilice el MCP argumentos mostrados en el MCP guía, o cambiar la prueba en línea a MCP para revisar su solicitud antes de añadirla a tu aplicación.

Ver planes y créditos Conecta esta API con MCP (en inglés)

Prueba esta API

Endpoint

https://api.nexscope.ai/sf/keywordSummary

Método MCP

nexscope_amazon_keyword_summary

Paso 1 de 3 · Autenticarse

Autenticación

Todos los endpoints de ejecución requieren una clave de API de usuario. Envíala como token bearer en la cabecera Authorization .

Authorization: Bearer nk-xxxxxxxxxxxxxxxxx

Las claves de API ausentes o no válidas devuelven un error de autenticación. Gestiona las claves desde .

Paso 2 de 3 · Enviar una solicitud

POSThttps://api.nexscope.ai/sf/keywordSummary

Ejecutar una API

Envía un cuerpo de solicitud JSON usando los parámetros descritos abajo.

Solicitud de ejemplo

Sustituye YOUR_API_KEY y ejecuta este comando en tu terminal.

curl -X POST 'https://api.nexscope.ai/sf/keywordSummary' \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "asins": "B01NBNDC1T,B09VLJJPL6",
  "country": "US",
  "pageSize": 50,
  "searchKeyword": "wireless charger"
}'

Ejemplo de código

{
  "asins": "B01NBNDC1T,B09VLJJPL6",
  "country": "US",
  "pageSize": 50,
  "searchKeyword": "wireless charger"
}

Paso 3 de 3 · Inspeccionar el resultado

Comprueba la respuesta

Consulta code para ver el estado de la solicitud y data para ver el resultado. Abre la referencia de parámetros y respuestas para consultar las definiciones completas de los campos.

Códigos de estado HTTP

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.

Ver parámetros y respuesta Probar en línea

Todas las categorías/ Inteligencia de búsquedas de Amazon SF

POSThttps://api.nexscope.ai/sf/keywordSummary

Ejecutar esta API

Envía una solicitud JSON para ejecutar esta API y recibir los datos de respuesta documentados.

Abrir área de pruebas

Endpoint

Método	`POST`
Ruta	`https://api.nexscope.ai/sf/keywordSummary`
Autenticación	`Bearer API key`
Content-Type	`application/json`

Parámetros de la solicitud

Nombre	Tipo	Obligatorio	Descripción
`searchKeyword`	`string`	obligatorio	Buscar palabras clave, longitud máxima 1000; intente utilizar el idioma del sitio objetivo
`country`	`string`	opcional	Sitio: `US`, `UK`, `DE`, `CA`, `JP`, `FR`, `ES`, `IT`, `MX`, `AU`, `AE`, `BR`, `SA` Ejemplo: US
`asins`	`string`	opcional	ASIN lista de filtros, separados por comas; longitud máxima 1000
`condition`	`string`	opcional	Sólo una condición puede ser pasada a la vez: `nfPosition`, `isSpAd`, `isVedioAd`, `isBrandAd`, `isPPCAd`, `isSearchRecommend`、`acAd`、`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`
`last7d`	`boolean`	opcional	Si tomar los últimos 7 días; cuando es `false`, utilice el rango de fechas Ejemplo: true
`startDate`	`string`	opcional	`yyyy-MM-dd`; surte efecto cuando `last7d=false`
`endDate`	`string`	opcional	`yyyy-MM-dd`; trabaja con `startDate`
`sortBy`	`string`	opcional	`totalKeywordNum`、`naturalKeywordNum`、`brandKeywordNum`、`vedioKeywordNum`、`acKeywordNum`、`erKeywordNum`、`trKeywordNum`、`sumScore`、`totalNfScore`、`totalSpSocre`、`totalBrandScore`、`totalVedioScore`、`totalAcScore`、`totalTrScore`、`totalErScore`
`pageNum`	`integer`	opcional	Número de página Ejemplo: 1
`pageSize`	`integer`	opcional	Número por página, rango 10–100 Ejemplo: 100
`desc`	`boolean`	opcional	Es el orden descendente Ejemplo: true

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 (55 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	ASIN palabra clave matriz de datos de tráfico
`columns`	`array`	opcional	render column
`type`	`string`	opcional	estilo de renderizado
`title`	`string`	opcional	Título
`costTime`	`integer`	opcional	Tiempo (ms)
`costToken`	`integer`	opcional	Consumir token
`asin`	`string`	opcional	ASIN código
`productTitle`	`string`	opcional	Título del producto
`productImageUrl`	`string`	opcional	Imagen principal URL
`productPrice`	`number`	opcional	Precio de venta del producto
`customerRatingCount`	`integer`	opcional	Calificaciones totales de los clientes
`productStarRating`	`number`	opcional	Categoría de estrella del producto
`productRatingScore`	`number`	opcional	Valor de la calificación del producto
`productUpdateTime`	`string`	opcional	Tiempo de actualización del producto
`dataPeriodStartDate`	`string`	opcional	Fecha de inicio del período de datos
`totalExposureScore`	`number`	opcional	Puntuación de la exposición total
`totalExposureRatio`	`number`	opcional	Cuota total de tráfico
`naturalSearchExposureScore`	`number`	opcional	Puntuación de exposición a la búsqueda orgánica total
`naturalSearchExposureRatio`	`number`	opcional	Relación de exposición a búsquedas naturales
`sponsoredProductsExposureScore`	`number`	opcional	SP anuncio impresión puntuación total
`sponsoredProductsExposureRatio`	`number`	opcional	Relación de exposición a la publicidad de SP
`brandAdExposureScore`	`number`	opcional	Puntuación total de exposición a la publicidad de marca
`brandAdExposureRatio`	`number`	opcional	Proporción de exposición a la publicidad de marcas
`videoAdExposureScore`	`number`	opcional	Puntuación total de exposición a anuncios de vídeo
`videoAdExposureRatio`	`number`	opcional	Relación de exposición a anuncios de vídeo
`amazonsChoiceExposureScore`	`number`	opcional	Puntuación total de la exposición a CA
`amazonsChoiceExposureRatio`	`number`	opcional	Relación de exposición de la CA
`editorialRecommendationsExposureScore`	`number`	opcional	Puntuación de exposición total de urgencias
`editorialRecommendationsExposureRatio`	`number`	opcional	Relación de exposición a ER
`topRatedExposureScore`	`number`	opcional	Puntuación total de exposición a TR
`topRatedExposureRatio`	`number`	opcional	Relación de exposición al TR
`recommendPositionExposureScore`	`number`	opcional	Puntuación total de la exposición a la posición recomendada
`recommendAdExposureScore`	`number`	opcional	Puntuación de exposición a la publicidad recomendada
`recommendAdExposureRatio`	`number`	opcional	Recomendado cuota de tráfico de publicidad
`recommendNonadExposureScore`	`number`	opcional	Posición recomendada Puntuación de la exposición no publicitaria
`recommendNonadExposureRatio`	`number`	opcional	Cuota de tráfico no publicitaria recomendada
`comprehensiveNaturalExposureScore`	`number`	opcional	Puntuación completa del tráfico orgánico
`comprehensiveNaturalExposureRatio`	`number`	opcional	Cotización del tráfico orgánico combinado
`keywordTotalExposureScore`	`number`	opcional	La puntuación total de esta palabra clave
`keywordNaturalExposureScore`	`number`	opcional	Puntuación natural para esta palabra clave
`keywordSponsoredProductsExposureScore`	`number`	opcional	Puntuación SP de esta palabra clave
`keywordBrandAdExposureScore`	`number`	opcional	Marca de puntuación de publicidad para esta palabra clave
`keywordVideoAdExposureScore`	`number`	opcional	Puntuación de anuncios de vídeo para esta palabra clave
`keywordAmazonsChoiceExposureScore`	`number`	opcional	Puntuación AC de esta palabra clave
`keywordRecommendExposureScore`	`number`	opcional	Puntuación de posición recomendada para esta palabra clave
`keywordRecommendAdExposureScore`	`number`	opcional	Puntuación publicitaria para posiciones recomendadas para esta palabra clave
`keywordRecommendNonadExposureScore`	`number`	opcional	Esta posición de recomendación de palabra clave no es una puntuación publicitaria
`keywordComprehensiveNaturalExposureScore`	`number`	opcional	Puntuación natural completa para esta palabra clave
`ppcTrafficSources`	`array`	opcional	Fuente de tráfico de PPC Etiquetas
`naturalSearchTrafficSources`	`array`	opcional	Etiqueta de fuente de tráfico de búsqueda orgánica
`amazonRecommendationSources`	`array`	opcional	Marca de origen recomendada por Amazon
`promotionalDealSources`	`array`	opcional	Etiqueta de la fuente de promoción

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.

Paso 1 de 2 · Conectar tu cliente MCP

MCP

Usa el endpoint MCP cuando un agente necesite descubrir y llamar a herramientas de API con JSON-RPC.

GET /mcp/legacy

POST /mcp/legacy
Authorization: Bearer nk-xxxxxxxxxxxxxxxxx
Content-Type: application/json

Paso 2 de 2 · Llamar a la herramienta

Llamar a una herramienta

{
  "jsonrpc": "2.0",
  "id": "tool-call-1",
  "method": "tools/call",
  "params": {
    "name": "nexscope_amazon_keyword_summary",
    "arguments": {
      "country": "US",
      "last7d": true,
      "pageNum": 1,
      "pageSize": 10,
      "searchKeyword": "phone case"
    }
  }
}

Prueba en línea

Ejecuta la API actual con tu clave de API y la carga JSON. Las pruebas en línea usan el entorno de API configurado de este sitio; el Endpoint y los ejemplos que puedes copiar usan la dirección de integración pública.

12 créditos / llamadaRegistros de uso de la API

Pruébalo

Envía una solicitud real con el mismo contrato que se muestra en la referencia.

Endpoint

/sf/keywordSummary

Método de MCP

nexscope_amazon_keyword_summary

Clave de API*

Contenido JSON*

cURL

curl -X POST \
  https://api.nexscope.ai/sf/keywordSummary \
  -H "Authorization: Bearer nk-..." \
  -H "Content-Type: application/json" \
  -d '{ "asins": "B01NBNDC1T,B09VLJJPL6", "country": "US", "pageSize": 50, "searchKeyword": "wireless charger" }'

Respuesta

Todavía no hay respuesta. Ejecuta la solicitud para ver la respuesta aquí.

API relacionadas

Amazon ASIN Keywords

Find keywords driving traffic to an Amazon ASIN.

Amazon ASIN Traffic Summary

Compare traffic sources and keyword changes for an ASIN.

Amazon Keyword Overview

Evaluate search demand and competition for an Amazon keyword.