Caso d'uso
Importa le recensioni AliExpress nel tuo negozio BigCommerce
BigCommerce ha una API per le recensioni, e AliExpress ha le recensioni. Collega le due con un breve script e i tuoi prodotti avranno recensioni native.
Due API, uno script
BigCommerce permette di creare recensioni prodotto tramite la Catalog API, quindi non c’è nulla da scrapare da parte tua e nulla da installare nel negozio. Ti servono solo le recensioni in un formato pulito, ed è ciò che restituisce questa API.
Le recensioni create in questo modo sono normali recensioni di BigCommerce: il tuo tema e la valutazione a stelle delle schede prodotto le usano come qualsiasi altra.
Come funziona
- Trova l’ID del prodotto AliExpress nell’URL: il numero in
aliexpress.com/item/1005006123456789.html. - Scegli le recensioni con
filter: una valutazione a stelle, recensioni con foto o recensioni di un paese. - Traducile con
langper adattarle alla lingua del tuo storefront. - Creale con
POST /v3/catalog/products/{id}/reviewsusando un token API di BigCommerce con lo scope dei prodotti.
Esempio: da AliExpress alle recensioni di BigCommerce
Uno script Node.js che legge le recensioni a 5 stelle di un prodotto AliExpress e le crea come recensioni di un prodotto BigCommerce. Imposta lo store hash, il token API e l’id del prodotto BigCommerce.
// Create BigCommerce product reviews from the 5-star reviews of an AliExpress product.
const API = 'https://api.aliexpress-reviews.com';
const STORE_HASH = process.env.BC_STORE_HASH;
const BC_PRODUCT_ID = 123; // your BigCommerce product
const res = await fetch(`${API}/v1/reviews/1005006123456789?filter=5&pageSize=20`, {
headers: { 'x-api-key': process.env.REVIEWS_API_KEY },
});
if (!res.ok) throw new Error(`HTTP ${res.status}`);
const { data } = await res.json();
for (const r of data) {
const created = await fetch(
`https://api.bigcommerce.com/stores/${STORE_HASH}/v3/catalog/products/${BC_PRODUCT_ID}/reviews`,
{
method: 'POST',
headers: {
'X-Auth-Token': process.env.BC_ACCESS_TOKEN,
'Content-Type': 'application/json',
Accept: 'application/json',
},
body: JSON.stringify({
title: r.content.slice(0, 60),
text: r.content,
status: 'pending', // review them in the control panel, then approve
rating: r.rating,
name: r.author,
date_reviewed: new Date(r.date).toISOString(),
}),
},
);
if (!created.ok) console.error(r.id, created.status, await created.text());
}Dettagli da curare
- Eseguilo lato server. Sia la API key delle recensioni sia il token di BigCommerce sono segreti: usa uno script, una funzione serverless o cron.
- Rispetta i rate limit di BigCommerce e crea le recensioni in sequenza o in piccoli lotti.
- Evita i duplicati salvando gli id delle recensioni AliExpress già create.
- Moderazione: creale con lo stato che preferisci (
pendingper rivederle prima,approvedper pubblicarle).
Usale con trasparenza
Mostrale come recensioni del prodotto di acquirenti AliExpress, non dei tuoi clienti. La normativa sui consumatori di molti paesi obbliga a informare sulla provenienza delle recensioni, ed è anche ciò che crea fiducia.
Domande
Quale permesso di BigCommerce mi serve?
Un account API a livello di negozio il cui token possa modificare i prodotti nello scope Catalog. Tieni il token sul server, come la API key delle recensioni.
Posso importare le foto delle recensioni?
Con il piano Max, filter=image restituisce solo le recensioni con foto e include i loro URL delle immagini. L’endpoint delle recensioni di BigCommerce non ha un campo per le immagini, quindi aggiungile al testo oppure ospitale tu.
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.