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.

Ottieni una API key gratisLeggi la documentazione

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

  1. Trova l’ID del prodotto AliExpress nell’URL: il numero in aliexpress.com/item/1005006123456789.html.
  2. Scegli le recensioni con filter: una valutazione a stelle, recensioni con foto o recensioni di un paese.
  3. Traducile con lang per adattarle alla lingua del tuo storefront.
  4. Creale con POST /v3/catalog/products/{id}/reviews usando 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.

Node.js — reviews to 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 (pending per rivederle prima, approved per 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.

Ottieni una API key gratisPrezzi