Caso d'uso
Importa le recensioni AliExpress nel tuo negozio Shopify
Il tuo prodotto ha migliaia di recensioni su AliExpress e nessuna nel tuo negozio. Ottienile in JSON, tieni quelle che contano e importale nella tua app di recensioni.
Il problema del copia e incolla
Una scheda prodotto nuova senza recensioni converte peggio, e le recensioni che il tuo fornitore ha già sono la migliore riprova sociale possibile. Ma copiarle da AliExpress una per una non scala, e le estensioni e gli scraper si rompono ogni volta che AliExpress cambia la sua pagina.
L'API ti dà le stesse recensioni che AliExpress mostra nella scheda prodotto, con gli stessi filtri, in un formato JSON stabile che puoi automatizzare.
Come funziona
- Trova l'ID del prodotto nell'URL di AliExpress: il numero in
aliexpress.com/item/1005006123456789.html. - Scegli le recensioni: solo 5 stelle (
filter=5), solo con foto (filter=image) o quelle degli acquirenti del paese dei tuoi clienti (filter=local&country=IT). - Traducile nella tua lingua con
lang:it_IT,es_ES,fr_FR… AliExpress restituisce la traduzione e il testo originale. - Esportale in CSV e importale con Judge.me, Loox, Ali Reviews o qualsiasi app che accetti un CSV.
Esempio: da AliExpress a un CSV in 20 righe
Questo script chiede le recensioni a 5 stelle di un prodotto e scrive un CSV. Sostituisci my-product con l'handle del prodotto su Shopify e adatta le colonne al modello di importazione della tua app di recensioni.
// Export the 5-star reviews of an AliExpress product as a CSV
// that review apps (Judge.me, Loox, Ali Reviews…) can import.
const API = 'https://api.aliexpress-reviews.com';
const headers = { 'x-api-key': process.env.REVIEWS_API_KEY };
const res = await fetch(`${API}/v1/reviews/1005006123456789?filter=5&pageSize=20`, { headers });
if (!res.ok) throw new Error(`HTTP ${res.status}`);
const { data } = await res.json();
const cell = (value) => `"${String(value ?? '').replaceAll('"', '""')}"`;
const header = ['product_handle', 'rating', 'body', 'reviewer_name', 'location', 'review_date', 'picture_urls'];
const rows = data.map((r) =>
['my-product', r.rating, r.content, r.author, r.country, r.date, (r.images ?? []).join(',')].map(cell).join(','),
);
console.log([header.join(','), ...rows].join('\n'));I filtri che contano per un negozio
- Con foto (
filter=image, piano Max): le recensioni con foto dei clienti sono quelle che convertono di più. La risposta include gli URL delle immagini. - Del tuo mercato (
filter=local+country, piano Pro): recensioni di acquirenti dello stesso paese dei tuoi clienti. - Tradotte (
lang, piano Pro): la recensione nella lingua del tuo negozio, conoriginalContentse vuoi mostrare l'originale. - Riepilogo delle valutazioni (tutti i piani): media, totale e distribuzione per stelle, da mostrare in cima alla scheda.
Usale con trasparenza
Mostrale per quello che sono: recensioni del prodotto di acquirenti AliExpress, non dei tuoi clienti. Molte app di recensioni permettono di indicare la fonte, e nell'UE la normativa sui consumatori obbliga a informare sulla provenienza delle recensioni. È anche ciò che crea fiducia.
Domande
Funziona con WooCommerce, Wix o altre piattaforme?
Sì. L'API restituisce JSON, che puoi convertire nel formato importato dalla tua piattaforma o dal tuo plugin di recensioni. L'esempio genera un CSV, il formato più comune.
Posso importare le foto delle recensioni?
Sì, con il piano Max: filter=image restituisce solo le recensioni con foto, e ogni recensione include gli URL delle sue immagini e miniature.
Quante recensioni posso ottenere?
Fino a 20 per richiesta con Free e fino a 100 con Pro e Max, con paginazione per scorrerle tutte. La quota è di 100, 1.000 o 10.000 richieste al giorno a seconda del piano.
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.