API de reseñas de Amazon

Qué devuelve esta API

El endpoint de reseñas de producto devuelve, página a página, las reseñas de clientes de un ASIN, con el texto y los metadatos necesarios para distinguir un tipo de reseña de otro.

Cada elemento de items[] es una reseña:

La lista completa está en la referencia de Product Reviews.

{
  "marketplace": "US",
  "asin": "B08CK5Z5Q1",
  "page": 1,
  "size": 2,
  "stars": [
    1,
    2
  ]
}

{
  "request_id": "3abbd602-e5d3-4372-900a-d7cc927f9a31",
  "data": {
    "total": 345,
    "pages": 173,
    "page": 1,
    "size": 2,
    "items": [
      {
        "author": "D…",
        "title": "Do not buy this piece of crap collar",
        "content": "I bought this collar 2 months ago  It is falling apart. The stitches are coming apart. Do not buy this piece of crap collar. I wish I could give this collar a 50 below zero rating<br>",
        "date": 1788710400000,
        "star": 1,
        "authorLabels": null,
        "skus": [
          "Size: Large (Pack of 1)",
          "Color: Teal"
        ],
        "likes": 0,
        "verified": false,
        "vine": false
      },
      {
        "author": "A…",
        "title": "D rings are now plastic - not metal! Very unhappy with this change.",
        "content": "I have purchased this collar in the past and was satisfied, but am returning the two collars I just purchased because the product is not the same now. The Amazon description still says the D ring is made of metal, but the collars I received have plastic D rings which are not acceptable as I believe they are a safety hazard for my large dogs.<br>",
        "date": 1787673600000,
        "star": 1,
        "authorLabels": [
          "Verified Purchase"
        ],
        "skus": [
          "Size: Large (Pack of 1)",
          "Color: Hotpink"
        ],
        "likes": 0,
        "verified": true,
        "vine": false
      }
    ]
  }
}

Ejemplo de petición

curl --request POST \
  --url https://ecommercedataapi.com/v1/amazon/review \
  --header "Content-Type: application/json" \
  --header "X-API-Key: ${ECOMMERCE_DATA_API_KEY}" \
  --data '{
    "marketplace": "US",
    "asin": "B08CK5Z5Q1",
    "page": 1,
    "size": 20,
    "stars": [1, 2, 3]
  }'

• asin es obligatorio; marketplace admite US, JP, UK, DE, FR, IT, ES, CA, IN, MX, BR, AU y AE. Para Amazon.es usa ES con un ASIN de ese marketplace.
• stars limita los resultados a esas valoraciones. [1, 2, 3] devuelve solo reseñas críticas, que es donde suele empezar el análisis.
• Pagina con page y size; la respuesta incluye total y pages.

Usos habituales

1. Encontrar qué corregir. Descarga las reseñas de 1 a 3 estrellas de tu ASIN y de tus competidores principales, y clasifica las quejas en problemas de producto, problemas del listing y casos aislados. Cómo analizar reseñas de Amazon explica el método.
2. Separar por variación. Agrupa por skus. Si las negativas se concentran en una talla o un color, el problema probablemente es ese SKU y no toda la línea de producto.
3. Seguir el historial de reseñas. Guarda date con cada reseña y compara periodos, por ejemplo antes y después de un cambio de producto o de una nueva versión del listing.
4. Ponderar según el origen. Separa las reseñas verified, vine, free y experience antes de contar el sentimiento. Los cuatro orígenes de una reseña de Amazon explica por qué no deben mezclarse, y exportar reseñas para analizarlas cubre la parte de hoja de cálculo.

Límites que conviene conocer

• Las reseñas de un ASIN son una muestra de los compradores que decidieron escribir. Una muestra pequeña o sesgada puede exagerar quejas poco frecuentes, así que mira los recuentos junto con likes y las fechas.
• Los listings padre comparten reseñas entre variaciones. Revisa el producto con detalles de producto antes de atribuir una reseña a una versión concreta.
• El texto de una reseña es la opinión de un cliente: puede señalar un problema, pero no demuestra su causa ni sirve como base para afirmaciones sobre el producto.
• Cada llamada correcta consume una unidad de facturación. Gestiona las respuestas 429 según errores y límites de uso.

Preguntas frecuentes

¿Tiene Amazon una API oficial de reseñas? Las APIs de vendedor y de publicidad de Amazon no devuelven el texto de las reseñas de cualquier producto. Este endpoint devuelve las reseñas de cualquier ASIN que le pases, en los marketplaces indicados arriba.

¿Puedo obtener solo las reseñas negativas? Sí. Pasa "stars": [1, 2] o [1, 2, 3].

¿Puede un agente de IA analizarlas por mí? Sí. El endpoint está disponible como herramienta en el servidor MCP remoto, así que un agente en Claude Code o Cursor puede obtener las reseñas y resumirlas en la misma conversación.