「Amazon レビュー API」を探す開発者が求めているのは、たいてい一つです。ASIN を渡して、レビュー本文を JSON で受け取ること。
Amazon 自身の API は、任意の商品についてそれを行いません。 返すのはレビューに関する情報、つまり件数、評価、要約されたトピックであり、それぞれ特定の種類のアカウントに限られます。どれがどれかを知っておけば、存在しないフィールドを探してドキュメントを 1 週間読む手間が省けます。
各公式 API がレビューについて返すもの
| API | 対象 | レビューについて返すもの | 任意の ASIN のレビュー本文 |
|---|---|---|---|
| Selling Partner API | 出品者とベンダー。自分のアカウントが対象 | 注文、商品情報、レポート。Customer Feedback API は要約されたレビュートピックを返し、個々のレビューは返さない | なし |
| アフィリエイト API（Product Advertising API と後継の Creators API） | 商品リンクを作成するアソシエイトやクリエイター | リンク作成用のカタログデータ。評価情報を含む | なし |
| Amazon Ads API | 広告主。自分のキャンペーンが対象 | キャンペーンの管理とレポート | なし |
この表について三点補足します。
Customer Feedback API が最も近いものの、要約です。 Amazon のドキュメントは、購入者のレビューと返品から得られるインサイトを ASIN とブラウズノードの単位で提供するものと説明しています。最も肯定的なトピックと最も否定的なトピックです。Amazon がすでに行った分析であり、レビューそのものではなく、利用には承認が必要です。
アフィリエイト API はリンクを作るためのものです。 購入者を Amazon に送るサイト向けです。Amazon のドキュメントは現在、Creators API を Product Advertising API 5.0 のサポート対象の後継としています。どちらで開発する場合も、先に現行の規約を確認してください。
本当の制約は範囲です。 出品者向けと広告向けの API は、自分のアカウントを対象とします。競合のレビューは権限の不足ではなく、設計上、範囲外です。同じ線引きがほかの種類のデータにも当てはまります。Amazon データ API の選び方で説明しています。
レビュー本文のリクエストはどのようなものか
この空白は第三者のデータエンドポイントが埋めます。次のエンドポイントは ASIN を受け取り、レビューをページ単位で返します。
curl --request POST \
--url https://ecommercedataapi.com/v1/amazon/review \
--header "Content-Type: application/json" \
--header "X-API-Key: ${ECOMMERCE_DATA_API_KEY}" \
--data '{
"marketplace": "US",
"asin": "B08CK5Z5Q1",
"page": 1,
"size": 20,
"stars": [1, 2, 3]
}'items[] の各要素が 1 件のレビューです。
| フィールド | 分かること |
|---|---|
star、title、content | 星の数とレビュー本文 |
date | レビューの日付。ミリ秒のタイムスタンプ |
skus | レビュアーが購入したバリエーション |
likes | 役に立ったと評価した購入者の数 |
verified、vine、free、experience | レビューの出所 |
image、video、images、videos | メディアの有無とそのリンク |
stars は評価で絞り込みます。[1, 2, 3] を指定すると批判的なレビューだけが返ります。レスポンスにはページ送り用の total と pages が含まれます。
Amazon レビュー分析 API のページに、対応マーケットプレイスと主な使い方をまとめています。
コードで対処すべき四つのこと
1. date は文字列ではなくタイムスタンプです。 月ごとに集計する前に変換してください。保存しておけば、商品の変更前後でレビューを比べられます。
2. バリエーションで分けるには skus を使います。 親の商品ページは、すべてのバリエーションのレビューをまとめています。「商品」に問題があると結論づける前に skus で集計してください。問題があるのは特定のサイズや色だけ、ということがよくあります。何がまとめられ、何がまとめられないかは親 ASIN と子 ASINで扱っています。
3. 四つの出所を分けておきます。 Vine のレビューと購入確認済みのレビューは別の証拠です。Amazon レビューの四つの出所で述べている理由から、別々に数えてください。
4. ページ送りは計画的に行います。 成功した呼び出し 1 回につき課金単位を 1 つ消費します。レビューが数千件ある商品では、すべて必要なのか、直近数か月の批判的なレビューだけでよいのかを先に決めてください。
レビューデータにできないこと
書くことを選んだ人の標本です。 まれな不満が実際より大きく見えます。件数は likes や日付と合わせて読んでください。
問題は示しますが、原因は示しません。 「動かなくなった」というレビューが 50 件あっても、どの部品が壊れたのかは分かりません。
商品の訴求の根拠にはなりません。 購入者の意見は試験による証拠ではありません。
取得したレビューの使い方は Amazon レビューの分析方法に、表計算で進める方法は Amazon レビューを表にエクスポートするにあります。低評価レビューをバリエーション別・テーマ別に分ける方法は低評価レビューをバリエーション別に読むにあります。
よくある質問
Amazon に公式のレビュー API はありますか。 任意の商品のレビュー本文を返すものはありません。Selling Partner API は承認された開発者に要約されたレビュートピックを提供し、アフィリエイト API はリンク作成用の評価情報を提供します。
低評価のレビューだけを取得できますか。
できます。"stars": [1, 2] または [1, 2, 3] を指定してください。
競合の商品のレビューを取得できますか。 できます。このエンドポイントは、対応マーケットプレイスの任意の ASIN を受け付けます。
AI エージェントにレビューを読ませることはできますか。 できます。同じエンドポイントがリモート MCP サーバーのツールになっているので、エージェントが 1 つの会話の中でレビューを取得して要約できます。