API de investigación de productos de Amazon: filtra por ventas, ingresos y BSR

Qué devuelve esta API

El endpoint de investigación de productos es un filtro sobre los listings de Amazon. Describes los productos que buscas —una palabra clave o una categoría, una franja de precio, un mínimo de ventas mensuales, un máximo de reseñas— y devuelve los listings que cumplen, una fila por producto, ordenados como pidas.

Responde a la primera pregunta de cualquier investigación de producto: qué productos de este nicho ya venden, a qué precio y con cuántas reseñas detrás.

Una petición real para cat water fountain en EE. UU., coincidencia de frase, últimos 30 días, al menos 300 unidades al mes y variaciones agrupadas devolvió 378 productos. La primera fila:

Puedes comprobar la cuenta: 52.585 unidades × 27,99 $ = 1.471.854 $, que es el valor de revenue. Esa fila es un listing con poco más de un año que ya vende más que productos con ocho veces sus reseñas: justo la señal que este endpoint sirve para encontrar. La lista completa de campos está en la referencia de investigación de productos.

Ejemplo de petición

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": "US",
    "month": "nearly",
    "keyword": "cat water fountain",
    "matchType": 1,
    "minUnits": 300,
    "variation": "Y",
    "page": 1,
    "size": 20,
    "order": { "field": "total_units", "desc": true }
  }'

• marketplace es el único campo obligatorio. Códigos admitidos: US, UK, DE, FR, IT, ES, MX, CA, AU, JP, IN, AE, BR.
• month admite nearly para los últimos 30 días o yyyyMM para un mes natural de los últimos 24.
• matchType es 1 frase, 2 amplia (por defecto) o 3 exacta. La coincidencia amplia con una palabra clave corta trae listings poco relacionados; empieza por frase.
• variation: "Y" agrupa las variaciones en una fila por padre, para que un producto con seis colores no cuente seis veces.
• Una consulta devuelve como máximo 2.000 registros. Estrecha los filtros en lugar de paginar más allá.

Los filtros que hacen el trabajo

Casi todo el valor está en los filtros. Los que se usan primero:

• Demanda: minUnits / maxUnits, minRevenue / maxRevenue y las tasas de crecimiento minUnitsCr y minRevenueCr, para encontrar productos que suben, no solo los grandes.
• Competencia: maxRatings deja los listings que aún no tienen una barrera de reseñas; minRatingsCv muestra cuáles siguen sumando reseñas este mes.
• Momento de entrada: availableMonth (1, 3, 6, 12 o 24) limita los resultados a listings recientes, la prueba más clara de que un recién llegado todavía puede entrar.
• Precio y margen: minPrice / maxPrice, maxFba, minProfit.
• Categoría: nodeIdPath o nodeIdPaths restringen a una ruta de categoría. Obtén la ruta con el endpoint de categorías.
• Vendedores: sellerNation, fulfillment (AMZ, FBA, FBM), maxSellers, includeBrands / excludeBrands.
• Distintivos: badgeBS, badgeAC y badgeNR exigen Best Seller, Amazon's Choice o New Release.

La coincidencia por palabra clave es textual, no por categoría. En la petición anterior, la segunda fila era una fuente para perros clasificada en Pet Supplies:Dogs. Si solo quieres una categoría, añade su nodeIdPath.

Usos habituales

1. Acotar un nicho. Elige la categoría, filtra por ventas y techo de reseñas y ordena la lista corta. El flujo de investigación de productos en lote encadena este endpoint con la investigación de mercado y la estimación de ventas por BSR.
2. Encontrar éxitos recientes. Usa availableMonth: 6 con un mínimo de minUnits para ver qué productos lanzados en los últimos seis meses ya venden. Si no hay ninguno, la categoría es más difícil de lo que su tamaño sugiere.
3. Revisar las franjas de precio. Ordena por total_units dentro de una categoría y mira dónde se concentran las ventas. El análisis de franjas de precio explica cómo convertirlo en un precio de lanzamiento.
4. Profundizar en un producto. Lleva un ASIN de los resultados a los endpoints de estimación de ventas, competidores y ASIN inverso.

Límites que conviene conocer

• units, revenue, profit y fba son estimaciones. Amazon no publica ventas en unidades; estas cifras se modelan a partir del ranking y otras señales públicas. Úsalas para comparar productos y ver tendencias, no como cifras contables. Qué pueden y qué no pueden decir las estimaciones de ventas explica cómo se obtienen.
• Algunos campos pueden venir vacíos en algunas filas: ratingsCv era null en una fila de la petición anterior. Trata un valor ausente como desconocido, no como cero.
• Cada llamada correcta consume una unidad de facturación, sea cual sea size. Pide hasta 100 filas por llamada.
• La respuesta no incluye una «puntuación de oportunidad» que decida por ti. Los umbrales los pones tú; cómo elegir una herramienta de investigación de productos explica por qué importa.

Preguntas frecuentes

¿Es la Product Advertising API de Amazon? No. La Product Advertising API devuelve datos de catálogo para afiliados y no tiene estimaciones de ventas ni filtros de investigación. Este endpoint está hecho para filtrar productos por demanda y competencia.

¿Puedo buscar por categoría en lugar de palabra clave? Sí. Envía nodeIdPath (o varias en nodeIdPaths) y omite keyword. Con nodeIdPathEqual: true se excluyen las subcategorías.

¿Puede usarla un agente de IA? Sí. El endpoint se ofrece como herramienta en el servidor MCP remoto, así que Claude, Cursor y otros clientes MCP pueden investigar productos dentro de una conversación.