Casi todo el mundo abre el catálogo de endpoints y se queda en el mismo punto: 46 endpoints, nombres parecidos y ningún punto de partida claro. Esta guía los reorganiza por el trabajo que quieres hacer en lugar de por nombre, para que encuentres los dos o tres que necesitas.
La lista completa está en el catálogo de API; aquí hablamos de cómo elegir.
Empieza por la pregunta, no por el endpoint
| Tu pregunta | Grupo | Cantidad |
|---|---|---|
| ¿Vale la pena entrar en esta categoría? | Analítica de mercado | 14 |
| ¿Qué productos concretos están vendiendo? | Datos de producto | 12 |
| ¿Qué buscan realmente los compradores? | Datos de palabras clave | 11 |
| ¿De dónde viene el tráfico de un competidor? | Analítica de tráfico | 3 |
| ¿Puedo usar este nombre de marca? | Marcas globales | 4 |
| Necesito extraer el texto de una imagen | Texto en imagen | 1 |
Los 46 endpoints comparten una sola autenticación y un solo saldo. No se suscribe por grupo.
Investigación de producto: primero la categoría o primero el producto
Hay dos puntos de entrada, y van en direcciones opuestas.
De arriba abajo, desde el tamaño del mercado. Market Research filtra nichos por nodo de categoría y unidades medias mensuales; después Market Statistics, Price Distribution y Brand Concentration indican si unas pocas marcas ya dominan el nicho.
De abajo arriba, desde una palabra clave o un producto. Product Research filtra por palabra clave, precio, valoración, número de vendedores y atributos del listing:
curl --request POST \
--url https://ecommercedataapi.com/v1/amazon/product/research \
--header "Content-Type: application/json" \
--header "X-API-Key: ${ECOMMERCE_DATA_API_KEY}" \
--data '{
"marketplace": "ES",
"month": "nearly",
"keyword": "alfombra de baño",
"matchType": 2,
"minPrice": 20,
"maxPrice": 80
}'Con los ASIN candidatos hay dos formas de estimar ventas: BSR Sales Estimate solo necesita un BSR y un ID de categoría, ideal para cribado masivo, y Product Sales Estimate trabaja por ASIN. Ambas devuelven estimaciones, no ventas declaradas por la plataforma.
Palabras clave: términos de búsqueda, términos de tráfico y ABA son tres cosas distintas
Se usan como sinónimos, pero corresponden a endpoints diferentes:
- Descubrimiento de términos — Keyword Miner y Keyword Research expanden un término semilla en consultas relacionadas con métricas de demanda y competencia.
- Búsqueda inversa de tráfico — Reverse Keyword Lookup recibe un ASIN y devuelve los términos con los que ese listing realmente consigue impresiones. Es el endpoint más directo para analizar competencia.
- Rankings ABA — ABA Weekly y ABA Monthly cubren el ranking de términos de búsqueda por semana o mes.
Dos ángulos más: Keyword Expansion parte de un conjunto de ASIN, y Google Keyword Trends añade demanda fuera de la plataforma.
Monitorización: convertir una consulta en una tarea diaria
Tras el lanzamiento importan otros campos. Tres endpoints forman el conjunto mínimo:
- Product Details — precio, BSR, valoración, número de reseñas, vendedores y logística actuales.
- Coupon Trends — la cadencia promocional de un competidor.
- Product History — curvas de precio y ranking a largo plazo.
Añade Product Competitors y Traffic Sources para el panorama competitivo. Cómo programarlo está en Monitorización de precios y cupones.
La comprobación de marca antes de publicar
Los cuatro endpoints de marcas se pasan por alto, pero son la verificación previa más barata: Trademark Search para saber si un nombre está tomado, Trademark Details para estado y clases, Trademark Statistics para la distribución de registros por oficina y Data Coverage para las oficinas soportadas. Desarrollado en Comprobar marcas antes de publicar.
Dos formas de llamar, elige una
REST encaja con tareas programadas, almacenes de datos y funciones de producto. Se autentica con la cabecera X-API-Key y el secreto se muestra una sola vez. Ver autenticación.
Un agente de IA encaja con análisis puntuales y con quien prefiere no escribir código. Instala el Skill una vez o conecta el servidor MCP remoto y describe la tarea en lenguaje natural. Ver Consultar datos de Amazon en Claude Code sin escribir código.
Ambas vías comparten catálogo y saldo de cuenta.
Cobertura y límites
- 13 marketplaces: US, UK, DE, FR, IT, ES, MX, CA, AU, JP, IN, AE, BR.
- Las cifras de ventas, tráfico y conversión son estimaciones que se revisan con el tiempo. Vuelve a comprobarlas con datos actuales antes de una decisión importante.
- Cada petición facturable correcta consume una llamada por defecto. Los límites de tasa y concurrencia se aplican por cuenta, así que crear más claves no amplía la cuota.
- El manejo de 429 y del resto de códigos está en errores y límites.