商品検索 API はキーワードを受け取り、商品を JSON で返します。「ページのない Amazon の検索結果」のように聞こえます。厳密にはそうではなく、その違いが結果を使えるかどうかを決めます。
リクエストの中で、ほかの何よりも重要な点が二つあります。マッチタイプと、結果がどう並ぶかを知っておくことです。
1 つのキーワード、三つのマッチタイプ
2026 年 10 月 12 日、米国のマーケットプレイスで同じキーワード pet water fountain を、match_type だけを変えて実行しました。
match_type | 一致した商品数 | 先頭に返ったもの |
|---|---|---|
broad（既定値） | 265,533 | ボトル入りの水、保温ボトル、赤ちゃん用おしりふき |
phrase | 1,880 | ペット用給水器と交換フィルター。すべてペット用品カテゴリー |
exact | 750 | 同じカテゴリーで、タイトルにそのフレーズを含むものに絞られる |
部分一致の結果はデータの不具合ではありません。 部分一致は、単語のどれか一つを含む商品を一致とみなします。「water」はカタログの非常に大きな部分に一致します。指定した単語のどれかを含む商品のうち、最も売れているものが先頭に来るため、上位にペット用給水器は一つもありませんでした。
したがって商品リサーチでは、ある単語の周辺にある商品をすべて取得したい場合を除き、match_type を phrase か exact にしてください。 既定値のままにすることが、最初のテストで結果がおかしく見える最も多い原因です。
curl --request POST \
--url https://ecommercedataapi.com/v1/amazon/product/competitor-lookup \
--header "Content-Type: application/json" \
--header "X-API-Key: ${ECOMMERCE_DATA_API_KEY}" \
--data '{
"marketplace": "US",
"keyword": "pet water fountain",
"match_type": "phrase",
"include_variations": false,
"page": 1,
"size": 20
}'結果は推定販売数の順に並ぶ
三つのテストすべてで、商品は units（月間販売数の推定）の多い順に返りました。フレーズ一致では、先頭の 8 件が 32,461 から 6,290 まで並びました。
これは購入者が目にする順序ではありません。 Amazon の検索結果ページは独自の関連性の順位で並び、スポンサー枠も含みます。このエンドポイントが答えるのは別の問いです。このキーワードに一致する商品のうち、どれが最も売れているか。
キーワードの市場規模を見積もるには正しい順序です。3 位にいるのが誰かを知りたいなら、誤った順序です。
各商品に含まれるもの
| フィールド | 分かること |
|---|---|
asin、parent、title、brand | どの商品か、その親はどれか |
price、averagePrice | 現在の価格と平均価格 |
bsr、subcategories | 売れ筋ランキングとサブカテゴリーの順位 |
units、revenue | 月間販売数と売上の推定 |
rating、ratings | 星の評価と評価数 |
sellers、sellerNation、fulfillment | 出品者の数、出品者の所在国、配送方法 |
nodeLabelPath | カテゴリーのパス。例えば Pet Supplies:Cats:Feeding & Watering Supplies:Fountains |
availableDate | 出品日。ミリ秒のタイムスタンプ |
レスポンスには total と pages も含まれます。page は最大 100、size は最大 200 です。
フィールドの一覧は Amazon 商品検索 API のページにあります。
結果に対して行う三つのこと
1. 数える前にカテゴリーで絞ります。 フレーズ一致でも、テストでは給水器と並んで交換フィルターが返りました。付属品のタイトルには本体のキーワードが入っているからです。一覧を一つの市場として扱う前に、nodeLabelPath と価格で分けてください。
2. units を正しい階層で読みます。 units は親の推定なので、バリエーションの多い商品は、バリエーションが一つの競合より大きく見えます。include_variations でバリエーションを個別に並べるかどうかを指定します。何がまとめられるかは親 ASIN と子 ASINで説明しています。
3. 販売数の分布を見ます。 上位 3 商品が販売数の大半を占めていれば、そのキーワードは集中しています。販売数がゆるやかに下がっていくなら、下位にも余地があります。この分布の読み方はキーワードを 1 ページ目に載せるで扱っています。
検索順位が必要な場合
「この商品はこのキーワードで何位か」が問いなら、商品検索ではなく逆引きを使います。流入キーワードエンドポイントは、1 つの ASIN について、表示されているキーワードを rankPosition（自然検索）と adPosition（スポンサー）とともに返します。読み方は Amazon ASIN のキーワード逆引きにあります。
| 知りたいこと | 使うもの |
|---|---|
| あるキーワードで最も売れている商品 | 商品検索。phrase または exact |
| ASIN のリストの価格、順位、販売数 | 商品検索に asins を指定（ASIN 検索） |
| ある商品が各キーワードで何位か | 逆引き |
| 条件に合うカテゴリー内のすべての商品 | 商品リサーチエンドポイント |
このデータにできないこと
購入者の検索結果ページは再現しません。 スポンサー枠も、パーソナライズも、ページのレイアウトもありません。
units と revenue は推定です。 商品同士を順位づけるのには向きますが、正確な数量としては使えません。Amazon の販売数データで分かること・分からないことを参照してください。
1 回の取得は 1 日分の姿です。 上のテストは 2026 年 10 月 12 日時点のもので、件数は変わります。
よくある質問
これは Amazon Product Advertising API ですか。 いいえ。あちらは商品リンクを作成するアフィリエイト向けの API です。このエンドポイントは、推定販売数や BSR のような調査用のフィールドを返します。
どのマッチタイプを使うべきですか。
まず phrase を使ってください。フレーズ一致でも関連の薄い商品が多く入る場合は exact を、ある単語の周辺をすべて取得したい場合にだけ broad を使います。
キーワードではなく ASIN で検索できますか。
できます。keyword の代わりに asins を指定し、最大 40 件の ASIN を渡します。どちらか一方だけを送ってください。
Amazon の自然検索の順位は取得できますか。 商品検索では取得できません。あるキーワードでの商品の位置は逆引きで取得します。