Investigación de producto masiva: reducir a una lista corta con tres endpoints

El techo de la investigación manual es cuántas páginas estás dispuesto a mirar. El sentido de usar una API no es la precisión, sino que el mismo filtro puede volver a ejecutarse la semana siguiente, con resultados comparables y criterios auditables.

Aquí va un flujo de tres pasos. Para claves y autenticación, ver autenticación; guarda el secreto en el servidor.

export ECOMMERCE_DATA_API_KEY="your_api_key"

Paso 1: decidir en qué categoría vale la pena entrar

Empieza por el tamaño de la categoría, no por un producto. Market Research filtra nichos por ruta de nodo de categoría y unidades medias mensuales:

curl --request POST \
  --url https://ecommercedataapi.com/v1/amazon/market/research \
  --header "Content-Type: application/json" \
  --header "X-API-Key: ${ECOMMERCE_DATA_API_KEY}" \
  --data '{
  "marketplace": "ES",
  "month": "202507",
  "nodeIdPath": "172282:281407",
  "minAvgUnits": 100,
  "maxAvgUnits": 10000,
  "page": 1
}'

minAvgUnits y maxAvgUnits sostienen este paso. El suelo descarta nichos sin demanda; el techo descarta los grandes ya saturados por marcas fuertes. Lo que queda en medio es la banda en la que puedes entrar, y las cifras concretas dependen de tu capital y tu logística.

Con las categorías candidatas, haz una ronda de descarte con Brand Concentration y Seller Concentration. Una categoría donde las marcas líderes acumulan demasiada cuota se puede descartar ya en investigación.

Paso 2: filtrar productos dentro de la categoría

Product Research es el paso más pesado y el que más condiciones admite:

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
}'

API de Product ResearchFiltra por categoría, ventas, ingresos, precio, valoración, vendedores y atributos del listing

Los tres grupos de condiciones hacen trabajos distintos:

Banda de precio — decide si tu estructura de costes puede competir. Es la restricción más dura.
Valoración y número de reseñas — pocas reseñas con buena valoración suele indicar que la posición aún no está bloqueada por reputación.
Número de vendedores — muchos vendedores en un ASIN señalan un mercado de reventa saturado. Míralo junto con la logística.

La lista completa de parámetros está en la documentación. month acepta nearly para el periodo más reciente, lo que evita cambiar el mes en cada ejecución programada.

Paso 3: ordenar la lista corta por magnitud

Con los candidatos hace falta un orden. BSR Sales Estimate solo necesita un BSR y un ID de categoría, lo que permite llamarlo sobre decenas o cientos de ASIN:

curl --request POST \
  --url https://ecommercedataapi.com/v1/amazon/sales/prediction/bsr \
  --header "Content-Type: application/json" \
  --header "X-API-Key: ${ECOMMERCE_DATA_API_KEY}" \
  --data '{
  "marketplace": "ES",
  "bsr": 1,
  "categoryId": "Category ID"
}'

Para una lectura más fina de un ASIN prioritario, usa Product Sales Estimate. Ambos son estimaciones.

Tres cosas que conviene hacer bien en una tarea programada

Una: los límites son por cuenta. El RPM y la concurrencia se aplican a nivel de cuenta, así que más claves no amplían la cuota. Controla tú la concurrencia en el paso 3 y aplica espera ante un 429 usando Retry-After: ver errores y límites.

Dos: solo se cobran las peticiones facturables correctas. Las que fallan antes de devolver un resultado facturable no se cobran, así que reintentar es seguro, pero un bucle mal escrito consume llamadas rápido. Haz funcionar el flujo con "size": 1 antes de abrir la paginación.

Tres: fija las definiciones. Pon marketplace y month en la configuración de la tarea, no repartidos por el código. Las definiciones desalineadas son la causa más habitual de comparaciones erróneas entre periodos.

Cómo leer los campos

Tipo	Ejemplos	Cómo usarlo
Visible en la plataforma	precio, valoración, reseñas, vendedores	Foto del momento; verificable y utilizable directamente
Estimación de terceros	unidades mensuales, ingresos, magnitud de demanda	Solo para ordenar y estimar magnitudes, nunca para proyección financiera
Métrica estructural	concentración de marcas, distribución de precios	Responde a «puedo entrar», no a «cuánto ganaría»

Límites

Las ventas y los ingresos son estimaciones que se revisan; el mismo ASIN puede leerse distinto una semana después.
Las rutas de nodo de categoría cambian por marketplace. Reutilizar un nodeIdPath entre marketplaces dará resultados erróneos.
Este flujo no cubre coste unitario, transporte ni certificaciones. Solo responde si merece la pena entrar en el mercado.

Para ejecutar el mismo flujo sin escribir código, delégalo a un agente: Delegar la investigación de producto a un agente de IA. El paso siguiente es el conjunto de palabras clave: Construir tu propia biblioteca de palabras clave.