ユースケース
ブログのための AliExpress レビュー
商品レビューの価値は、その根拠で決まります。評価の分布と、何千人もの実際の購入者の声で裏付けましょう。
意見から根拠へ
「AliExpress のおすすめ」系の記事の多くは、出品ページの内容を繰り返しているだけです。「452人の購入者から星4.4、そのうち7%が星1をつけていて、よくある不満は左のイヤホン」と書かれた記事のほうが役に立ち、信頼性も高く、読者が実際に検索するロングテールの質問でも上位に表示されます。
API を使えば、あらゆる商品のサマリーとレビューを取得できるので、推測ではなく購入者の声に基づいて書けます。
できること
- 記事に、平均、総数、星ごとの分布を表示する評価ボックスを表示できます。
- 星5と星1のレビューからメリットとデメリットを書くことも、LLM に要約させることもできます。
- 国と日付を添えて、読者の言語に翻訳した実際の購入者の声を引用できます。
- サイトを定期的に再ビルドして、数値が常に最新になるようまとめ記事を新鮮に保てます。
例：サイトのビルド時にデータを取得する
訪問者のブラウザではなく、ビルド時に実行してください。API key は非公開のままで、ページも高速に保てます。この Node.js スクリプトは、Astro、Eleventy、Next.js、Hugo、Jekyll がデータとして読み込める JSON ファイルを書き出します。
// build-reviews.mjs — run before your site builds (e.g. "prebuild": "node build-reviews.mjs").
// Writes the rating summary and the best and worst reviews of each product to a JSON file your pages can import.
import { writeFileSync } from 'node:fs';
const API = 'https://api.aliexpress-reviews.com';
const PRODUCTS = ['1005006123456789']; // AliExpress product ids you write about
const headers = { 'x-api-key': process.env.REVIEWS_API_KEY };
async function get(id, filter) {
const res = await fetch(`${API}/v1/reviews/${id}?filter=${filter}&pageSize=5`, { headers });
if (!res.ok) throw new Error(`${id}: HTTP ${res.status}`);
return res.json();
}
const out = {};
for (const id of PRODUCTS) {
const best = await get(id, '5');
const worst = await get(id, '1');
out[id] = { summary: best.summary, praise: best.data, complaints: worst.data };
}
writeFileSync('src/data/aliexpress-reviews.json', JSON.stringify(out, null, 2));押さえておきたいポイント
- key をクライアント側のコードに入れないでください。ブラウザ上のものは誰でもコピーできます。
- 1ビルドにつき商品ごとに1リクエストで十分です。サマリーはレビューの最初のページに含まれています。
- データの出典を明記し、商品へのリンクを張りましょう。読者も検索エンジンも、出典のある数値を信頼します。
- アフィリエイトの規約を確認してください。レビューや評価の引用の可否はプログラムによって異なります。
よくある質問
WordPress、Ghost、静的サイトでも使えますか？
はい。x-api-key ヘッダーを使う REST API なので、PHP、ビルドスクリプト、サーバーレス関数から呼び出し、結果を任意の CMS で表示できます。
ブラウザで直接レビューを表示できますか？
おすすめしません。key が誰にでも見えてしまいます。ビルド時に取得するか、ご自身のサーバー側の小さなエンドポイント経由で取得してください。
何リクエスト必要ですか？
サマリーと最初のレビューであれば、商品とビルドごとに1リクエストで十分です。Free プランは1日100リクエストなので、数十の商品を扱うブログなら足ります。
この API は AliExpress と提携していますか？
いいえ。AliExpress の商品ページに表示される公開レビューを返しますが、独立したサービスです。
ご自身の商品で試してみましょう
1日100リクエストまで無料、カード登録は不要です。ダッシュボードのテスターに商品 ID を貼り付けて、JSON を確認してください。