Amazon商品検索API

構造化データでAmazon商品を検索

Amazon Search APIでは、キーワードまたは完全一致のASINリストを使って商品を検索できます。現在の契約に応じて、商品情報、価格、推定販売、評価、レビュー数、Listing関連の項目が返されます。

エンドポイントと認証

• メソッド: POST
• 正規エンドポイント: https://ecommercedataapi.com/v1/amazon/product/competitor-lookup
• API code: amazon.products.search
• ドキュメント上の料金: 成功した呼び出し1回につき1 billing unit

API keyはサーバー側で管理し、X-API-Keyヘッダーで送信します。ブラウザコード、リポジトリ、ログには公開しないでください。

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": "wireless charger",
    "match_type": "broad",
    "include_variations": false,
    "page": 1,
    "size": 20
  }'

リクエストでは、用途に応じて marketplace、keyword または asins、match_type、include_variations、page、size を指定します。keyword と asins は同時に指定せず、どちらか一方を指定します。

推奨ワークフロー

対象マーケット、検索語、ページサイズを先に決め、返却された商品をカテゴリ、価格帯、評価対象の商品と比較します。結果は調査の根拠であり、売上や自然検索順位の保証ではありません。

制限事項

データは遅延、不完全、またはマーケットごとの差異を含む場合があります。2xx以外では request_id と error を確認し、429 のレート制限に従ってください。統合前に既存のProduct Searchドキュメントも確認してください。