ユースケース
AliExpress のレビューをBigCommerceストアにインポート
BigCommerce にはレビュー API があり、AliExpress にはレビューがあります。短いスクリプトで両者をつなげば、商品にネイティブなレビューが付きます。
2つの API、1つのスクリプト
BigCommerce では Catalog API を通じて商品レビューを作成できるため、こちら側でスクレイピングする必要も、ストアに何かをインストールする必要もありません。必要なのはクリーンな形式のレビューだけで、それをこの API が返します。
この方法で作成したレビューは通常の BigCommerce レビューなので、テーマや商品ページの星評価でも他のレビューと同じように使われます。
使い方
- URL からAliExpress の商品 ID を見つけます。
aliexpress.com/item/1005006123456789.htmlの数字です。 filterでレビューを選びます。星の数、写真付きのレビュー、または特定の国のレビュー。langでストアフロントの言語に合わせて翻訳します。- products スコープを持つ BigCommerce の API トークンを使って、
POST /v3/catalog/products/{id}/reviewsで作成します。
例:AliExpress から BigCommerce のレビューへ
AliExpress 商品の星5レビューを読み取り、BigCommerce 商品のレビューとして作成する Node.js スクリプトです。ストアハッシュ、API トークン、BigCommerce の商品 ID を設定してください。
// 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());
}押さえておきたいポイント
- サーバー側で実行します。レビュー API の key も BigCommerce のトークンもシークレットです。スクリプト、サーバーレス関数、cron を使ってください。
- BigCommerce のレート制限を守り、レビューは順番に、または小さなバッチで作成してください。
- 重複を避けるため、作成済みの AliExpress のレビュー ID を保存しておきます。
- モデレーション:お好みのステータスで作成できます(先に確認するなら
pending、公開するならapproved)。
誠実に活用しましょう
レビューは、あなたの顧客ではなく AliExpress の購入者による商品レビューであることを明示して表示してください。多くの国では消費者法によりレビューの出所を示すことが義務付けられており、それが信頼の構築にもつながります。
よくある質問
BigCommerce ではどの権限が必要ですか?
Catalog スコープで商品を変更できるトークンを持つ、ストアレベルの API アカウントです。トークンはレビュー API の key と同様に、サーバー上で保管してください。
レビューの写真もインポートできますか?
Max プランで可能です。filter=image で写真付きのレビューのみが返され、画像の URL も含まれます。ただし BigCommerce のレビューエンドポイントには画像フィールドがないため、本文に追加するか、ご自身でホストしてください。
レビューは何件取得できますか?
1リクエストあたり Free で最大20件、Pro と Max で最大100件で、ページネーションですべてのレビューを取得できます。クォータはプランに応じて1日100、1,000、10,000リクエストです。
この API は AliExpress と提携していますか?
いいえ。AliExpress の商品ページに表示される公開レビューを返しますが、独立したサービスです。
ご自身の商品で試してみましょう
1日100リクエストまで無料、カード登録は不要です。ダッシュボードのテスターに商品 ID を貼り付けて、JSON を確認してください。