Caso d'uso
Recensioni AliExpress per il tuo blog
La recensione di un prodotto vale quanto le prove che la sostengono. Sostieni la tua con la distribuzione delle valutazioni e le parole di migliaia di acquirenti reali.
Dall’opinione alle prove
La maggior parte dei post “il meglio di AliExpress” ripete la scheda del prodotto. Un post che dice “4,4 stelle da 452 acquirenti, il 7% dà 1 stella e la lamentela abituale riguarda l’auricolare sinistro” è più utile e più credibile, e si posiziona per le domande di coda lunga che i lettori cercano davvero.
Con l’API ottieni il riepilogo e le recensioni di qualsiasi prodotto, così puoi scrivere ciò che dicono gli acquirenti invece di tirare a indovinare.
Cosa puoi farci
- Mostrare un riquadro di valutazione nel post con la media, il totale e la distribuzione per stelle.
- Scrivere pro e contro dalle recensioni a 5 e a 1 stella, o lasciare che li riassuma un LLM.
- Citare acquirenti reali, con paese e data, tradotti nella lingua dei tuoi lettori.
- Tenere aggiornate le classifiche ricostruendo il sito a intervalli regolari, così i numeri restano attuali.
Esempio: ottieni i dati quando il tuo sito viene compilato
Fallo in fase di build, non nel browser del visitatore: la tua API key resta privata e le pagine restano veloci. Questo script Node.js scrive un file JSON che Astro, Eleventy, Next.js, Hugo o Jekyll possono leggere come dati.
// 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));Dettagli da curare
- Non mettere mai la chiave nel codice lato client. Tutto ciò che sta nel browser può essere copiato.
- Una richiesta per prodotto a ogni build basta: il riepilogo arriva con la prima pagina di recensioni.
- Indica da dove provengono i dati e inserisci un link al prodotto. Lettori e motori di ricerca si fidano dei numeri con fonte.
- Controlla le regole del tuo programma di affiliazione. I programmi differiscono su come permettono di citare recensioni e valutazioni.
Domande
Funziona con WordPress, Ghost o un sito statico?
Sì. È una API REST con un header x-api-key, quindi puoi chiamarla da PHP, da uno script di build o da una funzione serverless e mostrare il risultato in qualsiasi CMS.
Posso mostrare le recensioni direttamente nel browser?
Sconsigliamo di farlo: la chiave sarebbe visibile a chiunque. Ottienile in fase di build o tramite un piccolo endpoint lato server tuo.
Quante richieste mi servono?
Una per prodotto e per build basta per il riepilogo e le prime recensioni. Il piano Free ha 100 richieste al giorno, sufficienti per un blog con decine di prodotti.
L'API è affiliata ad AliExpress?
No. Restituisce le recensioni pubbliche che AliExpress mostra nelle sue schede prodotto, ma è un servizio indipendente.
Provala con i tuoi prodotti
100 richieste al giorno gratis, senza carta. Incolla l'ID di un prodotto nel tester della dashboard e guarda il JSON.