Casi todo el mundo exporta reseñas seleccionando la página, copiando y pegando en Excel.
La lentitud es el problema menor. El de verdad es que una hoja construida así no tiene las columnas que hacen falta para juzgar nada: obtienes el título, el cuerpo y las estrellas, y pierdes si la reseña fue una compra real, a qué variación pertenece y cuánta gente la encontró útil. Esas tres deciden si una reseña entra o no en tu conclusión.
Las 21 columnas en cuatro grupos
Grupo uno, procedencia (4 columnas). Marketplace, ASIN, fecha de recogida, fecha de la reseña.
La fecha de recogida y la de la reseña deben ir separadas. La de la reseña dice a qué momento pertenece ese comentario; la de recogida dice cuándo caduca la hoja. Si solo registras una, dos meses después no puedes saber si la hoja sigue siendo utilizable.
Grupo dos, la reseña en sí (4 columnas). Estrellas, título, extracto del contenido, SKU de la variación.
La columna de SKU es la que más falta en las hojas hechas a mano. Corresponde al campo skus e indica a qué variación se adjunta la reseña: un listing padre agrupa las reseñas de todas sus variaciones en una sola vista.
Grupo tres, origen y alcance (8 columnas). Compra verificada, Vine, gratuita, acceso anticipado, lleva imagen, lleva vídeo, votos de utilidad, etiquetas del autor.
Las cuatro primeras corresponden a los booleanos verified, vine, free y experience y deciden si una reseña entra en tu línea base. Las cuatro últimas deciden su alcance real: una negativa con foto y 47 votos y otra de solo texto con cero votos no son lo mismo. Los cuatro orígenes de una reseña de Amazon explica qué significa cada campo de origen.
Grupo cuatro, tu criterio (5 columnas). Cuenta en la línea base, categoría del problema, etapa, accionable, notas.
El endpoint no aporta nada de esto, así que se rellena a mano — y justamente por eso va físicamente separado de los tres grupos anteriores. Fundir observación y conclusión en una columna es un camino muy transitado para publicar una conjetura como hallazgo.
Qué campo del endpoint hay detrás de cada columna
La tercera fila de la hoja es la de correspondencia, escrita dentro del propio archivo:
| Columna | Campo del endpoint |
|---|---|
| Fecha de la reseña | date (timestamp) |
| Estrellas | star |
| Título | title |
| Extracto | content |
| SKU de la variación | skus |
| Compra verificada | verified |
| Vine | vine |
| Gratuita | free |
| Acceso anticipado | experience |
| Lleva imagen / vídeo | image / video |
| Votos de utilidad | likes |
| Etiquetas del autor | authorLabels |
Rellénala a mano en este orden y las columnas no se mueven cuando pases al endpoint. Ese es el objetivo de la hoja: la versión manual y la versión API son la misma hoja.
Tres trampas al exportar
Una: los campos de array no van directos a una celda.
skus, images, videos y authorLabels vuelven como arrays. Meterlos tal cual da un texto con corchetes que no se puede ordenar ni filtrar. Toma el primer valor o únelos con un separador, pero sé coherente en toda la hoja y no mezcles comas con puntos y coma, porque una coma te desplaza las columnas en CSV.
Dos: date es un timestamp, no una cadena de fecha.
Devuelve milisegundos desde época (el ejemplo documentado es 1772380800000). Pegado tal cual obtienes una ristra de dígitos, y ordenar por fecha da el orden equivocado. Conviértelo a YYYY-MM-DD al exportar, no al analizar.
Tres: los booleanos necesitan una sola grafía.
Los cuatro campos de origen devuelven verdadero/falso. Escríbelos de forma consistente como TRUE/FALSE o como sí/no, pero no ambos. Mezclarlos impide seleccionar "verificada y no Vine" con un solo filtro, que es el primer paso para calcular una puntuación de referencia.
Paginación y filtro por estrellas
El endpoint pagina por ASIN, y el parámetro stars acepta un array de puntuaciones.
Analizar problemas no exige todas las reseñas: pedir solo 1 y 2 estrellas ya te da la lista de defectos. Para la redacción más específica, toma la banda de 3 estrellas.
Una advertencia sobre la paginación: las reseñas se acumulan. La página 5 de hoy y la de la semana que viene no tienen por qué coincidir. Por eso la columna de fecha de recogida no es decorativa: es el número de versión de ese lote de datos.
Endpoint de reseñasReseñas paginadas por ASIN con filtro de estrellas; las tablas completas de parámetros y campos están en la documentaciónCuándo la hoja manual deja de bastar
Rellenar esta hoja con 50 reseñas de un ASIN lleva entre 30 y 40 minutos.
Las señales de que ya no encaja son claras:
- Más de un ASIN que vigilar. Cinco competidores a 50 reseñas cada uno es casi un día entero
- Revisiones periódicas. Las reseñas siguen llegando, así que la hoja del mes pasado ya describe mal el presente
- Agrupar por variación. Ordenar por
skusa mano va bien una vez y no va bien cada mes
Ese es el momento de convertirlo en una tarea programada. Para pasar de la hoja a conclusiones, mira Cómo analizar reseñas de Amazon. Las columnas no cambian: la fila de correspondencia ya lleva los nombres de los campos.
Preguntas
¿Puedo exportar todas las reseñas en una llamada? El endpoint devuelve páginas, así que la paginación es un bucle en tu lado. Con muchos ASIN esto dispara el volumen de llamadas, así que estímalo antes.
¿Por qué exporté menos reseñas de las que muestra la página?
Comprueba primero el nivel de ASIN. Una página padre agrupa todas las variaciones y quizá consultaste un hijo. Reconcilia con la columna skus.
¿Debe la hoja guardar el texto completo? Guarda un extracto. El texto completo vuelve la hoja muy difícil de leer, y el criterio suele estar en las dos primeras frases. Vuelve al original por fecha y estrellas cuando lo necesites.
¿Puede un modelo categorizar los problemas automáticamente?
Sí, y es la columna más adecuada para delegar en un modelo. Pero pon su salida en la columna de categoría del problema, dentro del grupo de criterio. Tiene que quedar separada de columnas factuales como content.