Investigación de palabras clave de Amazon

Analiza búsquedas, clics, compras, crecimiento y competencia de palabras clave para encontrar oportunidades en Amazon.

Disponibilidad: disponible

Cada llamada correcta consume 1 unidad. Los nombres de los campos y la estructura JSON forman parte del contrato de la API.

POST /v1/amazon/keyword-research

Correspondencia

Elemento	Valor
MCP Code	`keyword_research`
Método REST original	`POST`
Ruta REST original	`/v1/keyword-research`
Documentación original	Ver la documentación oficial

El alias anterior /v1/amazon/keywords/research sigue disponible durante la migración y devuelve Deprecation: true junto con un enlace a la ruta canónica.

Ejemplo completo

Crea una clave API y configúrala solo en el servidor:

export ECOMMERCE_DATA_API_KEY="your_api_key"
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":"N95","marketplace":"US","month":"202507","page":1,"size":20,"order":{"field":"searches","desc":true}}'

Envía los campos directamente en JSON, sin un objeto request adicional. marketplace es obligatorio; los demás filtros son opcionales. Para conservar una respuesta manejable, usa page y size y solicita campos concretos con returnFields cuando no necesites el resultado estándar.

Campo	Tipo	Descripción	Ejemplo
`marketplace`	String	Código del marketplace de Amazon.	`US`
`keywords`	String	Términos que se investigan.	`N95`
`departments`	Array	Categorías o departamentos incluidos.	`["automotive"]`
`excludeKeywords`	String	Términos que se excluyen.	`portable`
`marketPeriod`	String	Periodo de mercado solicitado.	`monthly`
`month`	String	Mes de los datos, normalmente `yyyyMM`.	`202507`
`minSearches`, `maxSearches`	Integer	Rango de búsquedas.	`100`, `300`
`minPurchases`, `maxPurchases`	Integer	Rango de compras.	`100`, `500`
`minProducts`, `maxProducts`	Integer	Rango de productos.	`10`, `90`
`minRatings`, `maxRatings`	Integer	Rango de valoraciones.	`2000`, `3000`
`minRating`, `maxRating`	Number	Rango de puntuación.	`3.2`, `4.8`
`minAvgPrice`, `maxAvgPrice`	Number	Rango de precio medio.	`20`, `30.3`
`minWordCount`, `maxWordCount`	Integer	Número de palabras del término.	`1`, `3`
`minSupplyDemandRatio`, `maxSupplyDemandRatio`	Number	Rango de relación oferta-demanda.	`5.6`, `10.4`
`withYearlyGrowth`	Boolean	Incluye crecimiento interanual.	`false`
`order`	Object	Orden de los resultados.	`{}`
`order.field`	String	Campo por el que ordenar, por ejemplo `searches`.	`searches`
`order.desc`	Boolean	`true` descendente, `false` ascendente.	`true`
`returnFields`	String	Lista de campos separada por comas.	`marketplace,keywords,searches`
`page`	Integer	Página desde 1.	`1`
`size`	Integer	Resultados por página.	`20`

Los filtros de crecimiento, clics, pujas, valor de producto y sus rangos mínimo/máximo también están disponibles en el esquema OpenAPI. Utiliza exactamente los nombres definidos allí; los campos desconocidos se rechazan.

Respuesta

{
  "request_id": "8fb43e59-4ff9-4dc8-a4b7-2ed164e45ab8",
  "data": {
    "pages": 1,
    "page": 1,
    "size": 20,
    "total": 1,
    "items": [
      {
        "marketplace": "US",
        "keywords": "polaroid cameras",
        "searches": 141356,
        "clicks": 100000,
        "purchases": 4029,
        "growth": -25.48,
        "purchaseRate": 0.0285,
        "products": 173,
        "supplyDemandRatio": 817.09
      }
    ]
  }
}

request_id sirve para soporte y diagnóstico. Cada elemento puede incluir marketplace, keywords, searches, clicks, impressions, purchases, growth, purchaseRate, products, supplyDemandRatio y departamentos, además de campos solicitados por returnFields.

Node.js y Python

const response = await fetch(
  'https://ecommercedataapi.com/v1/amazon/keyword-research',
  {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'X-API-Key': process.env.ECOMMERCE_DATA_API_KEY,
    },
    body: JSON.stringify({
      keywords: 'N95',
      marketplace: 'US',
      month: '202507',
      page: 1,
      size: 20,
    }),
  }
);
const result = await response.json();
if (!response.ok)
  throw new Error(`${result.error?.code}: ${result.error?.message}`);
console.log(result.data.items);

import os, requests
response = requests.post(
    "https://ecommercedataapi.com/v1/amazon/keyword-research",
    headers={"Content-Type": "application/json", "X-API-Key": os.environ["ECOMMERCE_DATA_API_KEY"]},
    json={"keywords": "N95", "marketplace": "US", "month": "202507", "page": 1, "size": 20},
    timeout=30,
)
response.raise_for_status()
print(response.json()["data"]["items"])

Interpretación y límites

Las búsquedas, compras, crecimiento y relación oferta-demanda son señales de investigación para una fecha y marketplace concretos. No equivalen a ventas garantizadas ni sustituyen la comprobación de competencia, costes, cumplimiento y margen. Ante 429, 503 o 504, respeta Retry-After; no reintentes errores de validación sin corregir el cuerpo.

Consulta Errores y límites, OpenAPI y crea una clave API.

AI skills and agents that use this API

Start from a seller task, see how these capabilities use the current API, and review source and permissions before installation.

Skill de Ecommerce Data API

Descubre y consulta APIs de Amazon en tiempo real desde agentes de programación compatibles.

Investigación de palabras clave de Amazon

Guía práctica para usar Investigación de palabras clave de Amazon con revisión humana.

Optimización de listings de Amazon

Guía práctica para usar Optimización de listings de Amazon con revisión humana.

Gestor de producto de Amazon

Guía práctica para usar Gestor de producto de Amazon con revisión humana.

Browse the complete AI Hub