API de palabras clave de Amazon: investigación y volumen de búsqueda

Qué devuelve esta API

El endpoint de investigación de palabras clave responde a lo que un vendedor necesita saber antes de elegir un término para su listing o su campaña: cuántas personas lo buscan cada mes en Amazon, cuántas de esas búsquedas terminan en compra y cuántos productos compiten por él.

Cada fila es una palabra clave en un marketplace y un mes. Los campos que más se usan:

Los ejemplos salen de la misma respuesta, así que puedes comprobar la aritmética: 2436 ÷ 17702 = 0,1376 y 17702 ÷ 364623 ≈ 0,05. La lista completa de campos está en la referencia de Keyword Research.

{
  "marketplace": "US",
  "keywords": "wireless charger",
  "month": "nearly",
  "page": 1,
  "size": 2
}

{
  "request_id": "b118bd5d-f4e0-45f5-879d-60f74b07f76d",
  "data": {
    "total": 429,
    "pages": 215,
    "page": 1,
    "size": 2,
    "items": [
      {
        "keywords": "wireless charger",
        "month": "2026.09",
        "searches": 168369,
        "searchMonthlyCr": -11.3,
        "purchases": 8301,
        "purchaseRate": 0.0493,
        "products": 103802,
        "supplyDemandRatio": 1.62,
        "avgPrice": 13.24,
        "avgRatings": 10326,
        "bid": 1.44,
        "bidMin": 0.9,
        "bidMax": 1.8,
        "araClickRate": 0.3084,
        "brands": [
          "SMILE STATION",
          "TNDAJI",
          "Anker"
        ]
      },
      {
        "keywords": "charger wireless",
        "month": "2026.09",
        "searches": 2167,
        "searchMonthlyCr": -5.78,
        "purchases": 203,
        "purchaseRate": 0.0939,
        "products": 102128,
        "supplyDemandRatio": 0.02,
        "avgPrice": 9.48,
        "avgRatings": 3428,
        "bid": 1.93,
        "bidMin": 1.45,
        "bidMax": 2.41,
        "araClickRate": 0.2879,
        "brands": [
          "LMOYPD",
          "SMILE STATION",
          "TNDAJI"
        ]
      }
    ]
  }
}

Ejemplo de petición

curl --request POST \
  --url https://ecommercedataapi.com/v1/amazon/keyword-research \
  --header "Content-Type: application/json" \
  --header "X-API-Key: ${ECOMMERCE_DATA_API_KEY}" \
  --data '{
    "keywords": "cargador inalambrico",
    "marketplace": "ES",
    "month": "202507",
    "page": 1,
    "size": 20
  }'

• marketplace es obligatorio. Códigos admitidos: US, JP, UK, DE, FR, IT, ES, CA, IN, MX, BR, AU, AE.
• month acepta yyyyMM para un mes natural (hasta 24 meses atrás) o nearly para los últimos 30 días.
• El cuerpo se valida de forma estricta: el campo es keywords (en plural). Los campos desconocidos se rechazan, no se ignoran.

Filtrar y ordenar por volumen de búsqueda

El endpoint consulta una base de palabras clave, no busca un solo término. En la misma petición puedes acotar y ordenar:

• minSearches / maxSearches mantienen los términos dentro de una franja de volumen, por ejemplo long tail entre 1.000 y 10.000 búsquedas al mes.
• minWordCount / maxWordCount separan términos genéricos de frases long tail.
• minPurchaseRate, minSupplyDemandRatio y maxProducts encuentran términos con mucha demanda en relación con la competencia.
• excludeKeywords elimina marcas o términos irrelevantes.
• order.field ordena por searches, crecimiento y otros campos documentados (tabla 1.8).

Usos habituales

1. Dimensionar un nicho antes de comprar stock. Obtén los términos alrededor de una palabra semilla, suma searches de los que describen tu producto y compara products para ver lo saturado que está. El flujo de investigación de productos muestra la secuencia completa.
2. Crear una biblioteca de palabras clave. Combina este endpoint con el minero de palabras clave y los rankings semanales de términos de búsqueda, y elimina duplicados. Consulta cómo crear tu biblioteca de palabras clave.
3. Detectar estacionalidad. Un solo mes de searches oculta los picos. El endpoint de tendencias de keywords devuelve el historial mensual; cómo leerlo se explica en investigación de productos de temporada.
4. Fijar una puja inicial. bid, bidMin y bidMax son una primera referencia para Sponsored Products; cómo ajustar a partir de ahí está en pujas por palabra clave.

Límites que conviene conocer

• searches, purchases y las pujas son estimaciones, no cifras publicadas por Amazon. Sirven para comparar términos y ver la tendencia; para tu propia marca, contrástalas con el informe de rendimiento de consultas de búsqueda de Brand Analytics.
• Cada herramienta llama «volumen de búsqueda» a métricas distintas. Cómo elegir una herramienta de palabras clave explica por qué no coinciden.
• Cada llamada correcta consume una unidad de facturación. Gestiona las respuestas 429 según errores y límites de uso.

Preguntas frecuentes

¿Son los mismos datos que la API de Amazon Ads? No. La API de Amazon Ads sirve para gestionar tus propias campañas e informar sobre ellas. Este endpoint devuelve estimaciones a nivel de marketplace para cualquier palabra clave, incluidas las que nunca has anunciado.

¿Qué marketplaces cubre? Los 13 indicados arriba, incluidos España (ES) y México (MX). Pasa el código de dos letras en marketplace.

¿Puede usarla un agente de IA? Sí. El endpoint está disponible como herramienta en el servidor MCP remoto, así que Claude Code, Cursor y otros clientes MCP pueden consultar palabras clave directamente.