Quien busca una «API de reseñas de Amazon» suele querer una sola cosa: enviar un ASIN y recibir el texto de las reseñas en JSON.
Ninguna de las API propias de Amazon hace eso con un producto cualquiera. Devuelven cosas relacionadas con las reseñas —recuentos, valoraciones, temas resumidos— y cada una está limitada a un tipo de cuenta. Saber cuál es cuál ahorra una semana leyendo documentación en busca de un campo que no existe.
Qué devuelve cada API oficial sobre reseñas
| API | Para quién es | Qué devuelve sobre reseñas | Texto de reseñas de cualquier ASIN |
|---|---|---|---|
| Selling Partner API | Vendedores y proveedores, sobre su propia cuenta | Pedidos, listings, informes. Su Customer Feedback API añade temas de reseñas resumidos, no reseñas individuales | No |
| API de afiliados (Product Advertising API y su sucesora, la Creators API) | Afiliados y creadores que generan enlaces de producto | Datos de catálogo para enlazar, incluida información de valoración | No |
| Amazon Ads API | Anunciantes, sobre sus propias campañas | Gestión de campañas e informes | No |
Tres notas sobre esa tabla.
La Customer Feedback API es la más cercana, y es un resumen. La documentación de Amazon la describe como información extraída de las reseñas y devoluciones de los clientes, a nivel de ASIN y de nodo de categoría: los temas más positivos y los más negativos. Es un análisis que Amazon ya ha hecho, no las reseñas en sí, y el acceso requiere aprobación.
La API de afiliados existe para crear enlaces. Está pensada para sitios que envían compradores a Amazon. La documentación de Amazon nombra ahora la Creators API como sucesora con soporte de la Product Advertising API 5.0, así que revisa las condiciones vigentes antes de construir sobre cualquiera de las dos.
El límite real es el alcance. Las API de vendedores y de publicidad tratan de tu propia cuenta. Las reseñas de un competidor quedan fuera por diseño, no por falta de permisos. La misma división se aplica a cualquier otro tipo de dato, como explica cómo elegir una API de datos de Amazon.
Cómo es una petición de texto de reseñas
Un endpoint de datos de terceros cubre ese hueco. Este recibe un ASIN y devuelve sus reseñas página a página:
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]
}'Cada elemento de items[] es una reseña:
| Campo | Qué te dice |
|---|---|
star, title, content | Valoración en estrellas y texto de la reseña |
date | Fecha de la reseña, como marca de tiempo en milisegundos |
skus | La variación que compró quien escribe |
likes | Cuántos compradores la marcaron como útil |
verified, vine, free, experience | De dónde procede la reseña |
image, video, images, videos | Si tiene contenido multimedia y sus enlaces |
stars filtra por valoración, de modo que [1, 2, 3] devuelve solo las reseñas críticas. La respuesta incluye total y pages para paginar.
La página de la API de reseñas de Amazon recoge los marketplaces y los usos habituales.
Cuatro cosas que resolver en el código
1. date es una marca de tiempo, no una cadena. Conviértela antes de agrupar por mes. Guardarla te permite comparar las reseñas de antes y después de un cambio en el producto.
2. skus es la forma de separar por variación. Un listing padre agrupa las reseñas de todas sus variaciones. Agrupa por skus antes de concluir que «el producto» tiene un problema; muchas veces lo tiene una talla o un color. ASIN padre e hijo explica qué se agrupa y qué no.
3. Mantén separadas las cuatro procedencias. Una reseña Vine y una compra verificada son pruebas distintas. Cuéntalas aparte, por las razones que da las cuatro procedencias de una reseña de Amazon.
4. Pagina con criterio. Cada llamada correcta consume una unidad de facturación. Con un producto de miles de reseñas, decide primero si las necesitas todas o solo las críticas de los últimos meses.
Lo que los datos de reseñas no pueden hacer
Son una muestra de quienes decidieron escribir. Las quejas poco frecuentes parecen mayores de lo que son. Lee los recuentos junto a likes y las fechas.
Muestran un problema, no su causa. Cincuenta reseñas que dicen «dejó de funcionar» no te dicen qué pieza falló.
No sirven de base para afirmaciones sobre el producto. La opinión de los clientes no es una prueba de ensayo.
Qué hacer con las reseñas una vez las tienes está en cómo analizar reseñas de Amazon, y la vía de la hoja de cálculo en exportar reseñas de Amazon a una hoja de cálculo. Cómo dividir las reseñas críticas por variación y por tema está en cómo leer las reseñas negativas por variación.
Preguntas frecuentes
¿Tiene Amazon una API oficial de reseñas? No una que devuelva el texto de las reseñas de cualquier producto. La Selling Partner API ofrece temas de reseñas resumidos a desarrolladores aprobados; la API de afiliados ofrece información de valoración para crear enlaces.
¿Puedo obtener solo las reseñas negativas?
Sí. Envía "stars": [1, 2] o [1, 2, 3].
¿Puedo obtener las reseñas del producto de un competidor? Sí. El endpoint acepta cualquier ASIN de los marketplaces admitidos.
¿Puede un agente de IA leer las reseñas por mí? Sí. El mismo endpoint es una herramienta del servidor MCP remoto, así que un agente puede obtener las reseñas y resumirlas en una sola conversación.