API リファレンス

はじめに

AliExpress Reviews API は、AliExpress の商品レビューを JSON で返します。HTTPS 上の単一の REST エンドポイントで、エラーを含むすべてのレスポンスが JSON です。

ベース URL

https://api.aliexpress-reviews.com

認証

x-api-key ヘッダー

形式

JSON, UTF-8

クイックスタート：無料のキーを作成し、ダッシュボードの API テスターで試すか、次のコマンドを実行します。

curl "https://api.aliexpress-reviews.com/v1/reviews/1005006123456789?filter=5&pageSize=20" \
  -H "x-api-key: $REVIEWS_API_KEY"

認証

ダッシュボードで API key を作成し、すべてのリクエストの x-api-key ヘッダーに含めて送信してください。キーは rv_ で始まります。

キーは作成時に一度だけ表示されます。保存しているのはキーそのものではなくハッシュです。紛失した場合はダッシュボードからローテーションしてください。古いキーは5分以内に使えなくなります。

キーはサーバー側で管理してください。キーを持っている人は誰でもあなたのクォータを消費できます。

GET /v1/reviews/{productId}

商品のレビュー1ページ分と、その評価のサマリーを返します。

パスパラメーター

クエリパラメーター

不明なパラメーターは 400 を返します。ご利用のプランに含まれないパラメーターは、値がデフォルトであっても 403 を返します。

リクエスト例

curl "https://api.aliexpress-reviews.com/v1/reviews/1005006123456789?filter=5&pageSize=20" \
  -H "x-api-key: $REVIEWS_API_KEY"

const url = new URL('https://api.aliexpress-reviews.com/v1/reviews/1005006123456789');
url.search = new URLSearchParams({ filter: '5', pageSize: '20' }).toString();

const res = await fetch(url, { headers: { 'x-api-key': process.env.REVIEWS_API_KEY } });
if (!res.ok) throw new Error((await res.json()).error.message);
const { summary, data } = await res.json();

import os, requests

res = requests.get(
    "https://api.aliexpress-reviews.com/v1/reviews/1005006123456789",
    params={"filter": "5", "pageSize": 20},
    headers={"x-api-key": os.environ["REVIEWS_API_KEY"]},
)
res.raise_for_status()
body = res.json()

フィルター

フィルターは AliExpress の商品ページに表示されるものと同じで、AliExpress 側で適用されます。filter は1リクエストにつき1つだけ指定でき、組み合わせることはできません。

レスポンスの summary.filterCounts で各フィルターが返すレビュー数がわかるため、追加のリクエストなしで UI から空のフィルターを非表示にできます。

言語

lang（Pro）を指定すると、content と additionalFeedback が AliExpress によって翻訳されて返されます。originalContent には常に購入者自身の言葉がそのまま残ります。

レスポンス

{
  "productId": "1005006123456789",
  "filter": "all",
  "page": 1,
  "pageSize": 20,
  "total": 452,
  "totalPages": 23,
  "summary": {
    "averageRating": 4.4,
    "totalReviews": 452,
    "ratingDistribution": { "5": 323, "4": 54, "3": 33, "2": 12, "1": 30 },
    "filterCounts": { "all": 452, "image": 32, "additional": 6, "local": 63 }
  },
  "data": [
    {
      "id": "60012345678901234",
      "author": "J***n",
      "country": "ES",
      "rating": 5,
      "content": "Very good quality, arrived in 10 days",
      "originalContent": "Muy buena calidad, llegó en 10 días",
      "additionalFeedback": null,
      "date": "2026-08-09",
      "sku": "Color:Black",
      "helpfulVotes": 3,
      "images": ["https://..."],
      "thumbnails": ["https://..."]
    }
  ]
}

ページのフィールド

レビューのフィールド

Free と Pro では images と thumbnails は省略されます。

ページネーション

page が totalPages に達するまで、page=1、2、… とリクエストします。各ページがクォータの1リクエストとして計上されるため、プランで許可されている最大の pageSize を使ってください。

async function allReviews(productId, filter = 'all') {
  const reviews = [];
  for (let page = 1; ; page++) {
    const url = `https://api.aliexpress-reviews.com/v1/reviews/${productId}?filter=${filter}&page=${page}`;
    const res = await fetch(url, { headers: { 'x-api-key': process.env.REVIEWS_API_KEY } });
    const body = await res.json();
    reviews.push(...body.data);
    if (page >= body.totalPages) return reviews;
  }
}

レート制限

クォータは 00:00 UTC にリセットされます。クォータに計上されるすべてのレスポンス（200、404、429、502）には次のヘッダーが含まれます。

400/401/403 で拒否されたリクエストは計上されません。クォータを超えると、リセットまで 429 が返されます。また、全ユーザー共通で毎秒50リクエストのグローバル制限があります。

キャッシュ

各ページ（商品＋パラメーター）は最大24時間キャッシュされるため、新しいレビューが表示されるまで最大1日かかることがあります。キャッシュされたレスポンスもクォータに計上されます。

エラー

エラーは標準的な HTTP ステータスコードと、次の JSON ボディで返されます。

{ "error": { "message": "filter=image requires the MAX plan" } }

OpenAPI

完全な仕様は /openapi.json（OpenAPI 3.0）にあります。Postman、Insomnia、クライアントジェネレーターにインポートして使えます。