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.
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
- Trouvez l’ID du produit AliExpress dans l’URL : le nombre de
aliexpress.com/item/1005006123456789.html. - Choisissez les avis avec
filter: une note en étoiles, les avis avec photos ou ceux d’un pays. - Traduisez-les avec
langpour qu’ils correspondent à la langue de votre vitrine. - Créez-les avec
POST /v3/catalog/products/{id}/reviewsen 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.
// 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 (
pendingpour les relire d’abord,approvedpour 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.