API de búsqueda de productos de Amazon

Qué devuelve esta API

El endpoint de búsqueda de productos recibe una palabra clave o una lista de ASIN y devuelve los productos de Amazon que coinciden como registros estructurados. Puedes comparar una página de resultados entera sin hacer scraping.

Cada elemento de items[] describe un producto. Los campos que más se usan:

Los ejemplos salen de una misma respuesta documentada: revenue es units × averagePrice (167539 × 735,81 ≈ 123276872). La lista completa está en la referencia de Product Search.

{
  "marketplace": "US",
  "keyword": "wireless charger",
  "match_type": "phrase",
  "page": 1,
  "size": 10
}

{
  "request_id": "392dfdcb-8c88-4c5b-b2f2-2115df573e3b",
  "data": {
    "total": 4615,
    "pages": 462,
    "page": 1,
    "size": 10,
    "items": [
      {
        "asin": "B0CNTH3F7P",
        "brand": "Ouotoo",
        "title": "3 in 1 Mag-Safe Wireless Charger Stand for iPhone Apple Watch AirPods",
        "nodeLabelPath": "Cell Phones & Accessories:Accessories:Chargers & Power Adapters:Wireless Chargers",
        "bsr": 45,
        "price": 21.99,
        "units": 44607,
        "revenue": 802479.94,
        "rating": 4.4,
        "ratings": 9018,
        "availableDate": 1702425600000,
        "fulfillment": "FBA",
        "sellers": 3,
        "sellerNation": "CN"
      },
      {
        "asin": "B0GGPBR4YP",
        "brand": "SMILE STATION",
        "title": "MagSafe 25W Wireless Charger for Apple Magnetic Fast Charging Pad",
        "nodeLabelPath": "Cell Phones & Accessories:Accessories:Chargers & Power Adapters:Wireless Chargers",
        "bsr": 42,
        "price": 13.92,
        "units": 44206,
        "revenue": 615347.5,
        "rating": 4.4,
        "ratings": 3610,
        "availableDate": 1768435200000,
        "fulfillment": "FBA",
        "sellers": 7,
        "sellerNation": "CN"
      },
      {
        "asin": "B0BFCC18FS",
        "brand": "Anlmz",
        "title": "Anlmz 3 in 1 Charging Station - Wireless Charger for Apple Multiple Devices",
        "nodeLabelPath": "Cell Phones & Accessories:Accessories:Chargers & Power Adapters:Charging Stations",
        "bsr": 59,
        "price": 15.29,
        "units": 35954,
        "revenue": 549736.7,
        "rating": 4.2,
        "ratings": 41555,
        "availableDate": 1664236800000,
        "fulfillment": "FBA",
        "sellers": 8,
        "sellerNation": "CN"
      }
    ]
  }
}

Ejemplo de petición

curl --request POST \
  --url https://ecommercedataapi.com/v1/amazon/product/competitor-lookup \
  --header "Content-Type: application/json" \
  --header "X-API-Key: ${ECOMMERCE_DATA_API_KEY}" \
  --data '{
    "marketplace": "ES",
    "keyword": "cargador inalambrico",
    "match_type": "phrase",
    "include_variations": false,
    "page": 1,
    "size": 20
  }'

• Envía solo uno de keyword o asins. asins acepta un array como ["B08CK5Z5Q1"] cuando ya sabes qué productos comparar.
• include_variations decide si las variaciones se incluyen en los resultados.
• marketplace admite US, JP, UK, DE, FR, IT, ES, CA, IN, MX, BR, AU y AE.
• Los resultados se paginan con page y size; la respuesta incluye total y pages.

Usos habituales

1. Leer una página de resultados como una tabla. Busca el término en el que quieres posicionar y ordena por units o revenue para ver cómo se reparte la demanda entre los primeros listings. Qué mirar se explica en cómo llegar a la primera página.
2. Crear un grupo de competidores. Pasa tu ASIN y los de tus competidores principales en asins para obtener los mismos campos de todos en una llamada. El método de análisis de competidores convierte esa tabla en decisiones.
3. Preseleccionar productos. De los resultados, quédate con los que están en tu franja de precio y con un número de valoraciones al que puedas competir, y revísalos con detalles de producto. Para filtrar una categoría entera, el endpoint de investigación de productos ofrece filtros por rangos sin palabra clave. Consulta el flujo de investigación de productos.
4. Sustituir un scraper. Una API estructurada evita CAPTCHAs, cambios de diseño y costes de proxies; los costes ocultos del scraping en Amazon compara ambos enfoques.

Límites que conviene conocer

• units y revenue son estimaciones de un modelo, no las cifras de ventas de Amazon. Son fiables para ordenar y comparar productos, no para leerlas como volúmenes exactos. Qué pueden y qué no pueden decir las estimaciones de ventas lo detalla.
• Los campos que no existen para un producto llegan como null o -1 (por ejemplo primePrice: -1); compruébalos antes de operar con ellos.
• Cada llamada correcta consume una unidad de facturación. Gestiona las respuestas 429 según errores y límites de uso.

Preguntas frecuentes

¿Es la Product Advertising API de Amazon? No. La Product Advertising API está pensada para afiliados y no devuelve estimaciones de ventas ni historial de BSR. Este endpoint está hecho para investigación de productos y mercados, y no requiere una cuenta de Afiliados.

¿Puedo consultar un solo ASIN? Sí, pásalo en asins. Para ver más datos de un producto, como el listing completo, usa detalles de producto.

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