ユースケース

AliExpress のレビューをBigCommerceストアにインポート

BigCommerce にはレビュー API があり、AliExpress にはレビューがあります。短いスクリプトで両者をつなげば、商品にネイティブなレビューが付きます。

無料の API key を取得ドキュメントを読む

2つの API、1つのスクリプト

BigCommerce では Catalog API を通じて商品レビューを作成できるため、こちら側でスクレイピングする必要も、ストアに何かをインストールする必要もありません。必要なのはクリーンな形式のレビューだけで、それをこの API が返します。

この方法で作成したレビューは通常の BigCommerce レビューなので、テーマや商品ページの星評価でも他のレビューと同じように使われます。

使い方

  1. URL からAliExpress の商品 ID を見つけます。aliexpress.com/item/1005006123456789.html の数字です。
  2. filter でレビューを選びます。星の数、写真付きのレビュー、または特定の国のレビュー。
  3. lang でストアフロントの言語に合わせて翻訳します。
  4. products スコープを持つ BigCommerce の API トークンを使って、POST /v3/catalog/products/{id}/reviews で作成します。

例:AliExpress から BigCommerce のレビューへ

AliExpress 商品の星5レビューを読み取り、BigCommerce 商品のレビューとして作成する Node.js スクリプトです。ストアハッシュ、API トークン、BigCommerce の商品 ID を設定してください。

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());
}

押さえておきたいポイント

  • サーバー側で実行します。レビュー 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 を確認してください。

無料の API key を取得料金