Caso de uso
Reviews de AliExpress para tu blog
Un análisis de producto vale lo que valen sus pruebas. Respalda el tuyo con la distribución de valoraciones y las palabras de miles de compradores reales.
De la opinión a las pruebas
La mayoría de los posts de “lo mejor de AliExpress” repiten el anuncio. Un post que dice “4,4 estrellas de 452 compradores, un 7 % da 1 estrella y la queja habitual es el auricular izquierdo” es más útil y más creíble, y posiciona para las preguntas de cola larga que los lectores buscan de verdad.
Con la API obtienes el resumen y las reseñas de cualquier producto, así que puedes escribir sobre lo que dicen los compradores en lugar de adivinar.
Qué puedes hacer con ella
- Mostrar una caja de valoración en tu post con la media, el total y la distribución por estrellas.
- Escribir pros y contras a partir de las reseñas de 5 y 1 estrellas, o dejar que un LLM las resuma.
- Citar a compradores reales, con país y fecha, traducidos al idioma de tus lectores.
- Mantener los listados al día recompilando el sitio de forma programada para que las cifras estén siempre actualizadas.
Ejemplo: obtén los datos cuando se compile tu sitio
Hazlo al compilar, no en el navegador del visitante: tu API key sigue siendo privada y tus páginas siguen siendo rápidas. Este script de Node.js escribe un archivo JSON que Astro, Eleventy, Next.js, Hugo o Jekyll pueden leer como datos.
// build-reviews.mjs — run before your site builds (e.g. "prebuild": "node build-reviews.mjs").
// Writes the rating summary and the best and worst reviews of each product to a JSON file your pages can import.
import { writeFileSync } from 'node:fs';
const API = 'https://api.aliexpress-reviews.com';
const PRODUCTS = ['1005006123456789']; // AliExpress product ids you write about
const headers = { 'x-api-key': process.env.REVIEWS_API_KEY };
async function get(id, filter) {
const res = await fetch(`${API}/v1/reviews/${id}?filter=${filter}&pageSize=5`, { headers });
if (!res.ok) throw new Error(`${id}: HTTP ${res.status}`);
return res.json();
}
const out = {};
for (const id of PRODUCTS) {
const best = await get(id, '5');
const worst = await get(id, '1');
out[id] = { summary: best.summary, praise: best.data, complaints: worst.data };
}
writeFileSync('src/data/aliexpress-reviews.json', JSON.stringify(out, null, 2));Detalles que conviene cuidar
- Nunca pongas la key en código del lado del cliente. Todo lo que está en el navegador se puede copiar.
- Una petición por producto y compilación es suficiente: el resumen viene con la primera página de reseñas.
- Indica de dónde vienen los datos y enlaza al producto. Los lectores y los buscadores confían en las cifras con fuente.
- Revisa las normas de tu programa de afiliados. Los programas difieren en cómo permiten citar reseñas y valoraciones.
Preguntas
¿Funciona con WordPress, Ghost o un sitio estático?
Sí. Es una API REST con una cabecera x-api-key, así que puedes llamarla desde PHP, desde un script de compilación o desde una función serverless y mostrar el resultado en cualquier CMS.
¿Puedo mostrar las reseñas directamente en el navegador?
Recomendamos que no: la key sería visible para cualquiera. Obtén los datos al compilar o a través de un pequeño endpoint propio en el servidor.
¿Cuántas peticiones necesito?
Una por producto y compilación basta para el resumen y las primeras reseñas. El plan Free tiene 100 peticiones al día, lo que cubre un blog con decenas de productos.
¿La API está afiliada a AliExpress?
No. Devuelve las reseñas públicas que AliExpress muestra en sus fichas de producto, pero es un servicio independiente.
Pruébalo con tus productos
100 peticiones al día gratis, sin tarjeta. Pega el ID de un producto en el tester del panel y mira el JSON.