Cas d'usage

Importez les avis AliExpress dans votre boutique BigCommerce

BigCommerce a une API d’avis, et AliExpress a les avis. Reliez les deux avec un court script et vos produits auront des avis natifs.

Obtenir une clé API gratuiteVoir la documentation

Deux API, un seul script

BigCommerce permet de créer des avis produit via la Catalog API : il n’y a rien à scraper de votre côté ni rien à installer dans la boutique. Il vous faut seulement les avis dans un format propre, ce que renvoie cette API.

Les avis créés ainsi sont de simples avis BigCommerce : votre thème et la note en étoiles de vos fiches produit les utilisent comme les autres.

Comment ça marche

  1. Trouvez l’ID du produit AliExpress dans l’URL : le nombre de aliexpress.com/item/1005006123456789.html.
  2. Choisissez les avis avec filter : une note en étoiles, les avis avec photos ou ceux d’un pays.
  3. Traduisez-les avec lang pour qu’ils correspondent à la langue de votre vitrine.
  4. Créez-les avec POST /v3/catalog/products/{id}/reviews en utilisant un token d’API BigCommerce avec le scope products.

Exemple : d’AliExpress aux avis BigCommerce

Un script Node.js qui lit les avis 5 étoiles d’un produit AliExpress et les crée comme avis d’un produit BigCommerce. Indiquez le hash de votre boutique, le token d’API et l’id du produit 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());
}

Les détails à soigner

  • Exécutez-le côté serveur. La clé API des avis et le token BigCommerce sont des secrets : utilisez un script, une fonction serverless ou cron.
  • Respectez les limites de débit de BigCommerce et créez les avis séquentiellement ou par petits lots.
  • Évitez les doublons en stockant les ids des avis AliExpress déjà créés.
  • Modération : créez-les avec le statut que vous préférez (pending pour les relire d’abord, approved pour les publier).

Utilisez-les en toute transparence

Présentez-les comme des avis sur le produit laissés par des acheteurs AliExpress, pas par vos clients. Le droit de la consommation de nombreux pays impose d’informer sur l’origine des avis, et c’est aussi ce qui crée la confiance.

Questions

De quelle permission BigCommerce ai-je besoin ?

D’un compte API au niveau de la boutique dont le token peut modifier les produits dans le scope Catalog. Gardez le token côté serveur, comme la clé API des avis.

Puis-je importer les photos des avis ?

Avec le plan Max, filter=image renvoie uniquement les avis avec photos et inclut leurs URL d’images. L’endpoint d’avis de BigCommerce n’a pas de champ image : ajoutez-les au texte ou hébergez-les vous-même.

Combien d'avis puis-je récupérer ?

Jusqu'à 20 par requête en Free et jusqu'à 100 en Pro et Max, avec pagination pour tous les parcourir. Le quota est de 100, 1 000 ou 10 000 requêtes par jour selon le plan.

L'API est-elle affiliée à AliExpress ?

Non. Elle renvoie les avis publics qu'AliExpress affiche sur ses fiches produit, mais c'est un service indépendant.

Essayez avec vos propres produits

100 requêtes par jour gratuites, sans carte bancaire. Collez l'ID d'un produit dans le testeur de votre tableau de bord et regardez le JSON.

Obtenir une clé API gratuiteTarifs