Amazon Product Search
Amazon Product Searchは、商品フレーズとストアフロントのURLから、正規化された公開商品レコードを生成します。値が取得可能な場合、各アイテムにはソースURL、タイトル、説明文、セラー、価格、評価、レビュー数、販売数、メディア、公開日時、取得日時が含まれます。
Amazon Product Search API の主な機能
- ストアフロントを指定したクエリ空でない商品 query と対応するAmazonの domain を1つ組み合わせ、検索対象のストアフロントを明示します。
- 結果件数の制御results_limit を1〜2,000の整数で設定します。指定した上限に達するか、ソースにそれ以上のレコードがなくなった時点で取得は停止します。
- 正規化された商品情報ID、種別、ソースURL、タイトル、説明文、公開日時、取得日時の安定した商品フィールドを受け取れます。
- コマース情報ストアフロントごとに異なる結果の形式を解析することなく、取得可能なセラー、価格、評価、レビュー数、販売数、メディアのフィールドを利用できます。
Amazon Product Search API のパラメータ
| パラメータ | 必須 | 説明 |
|---|---|---|
query | 必須 | 必須。空でない商品キーワードまたはフレーズです。 |
domain | 必須 | 必須。Amazonストアフロントの参照URLです。解析したホスト名は amazon.com、amazon.co.uk、amazon.de、amazon.fr、amazon.es、amazon.it、amazon.ca、amazon.com.au、amazon.in、amazon.co.jp またはそのサブドメインである必要があります。ホスト名があればスキームは問わず、プロトコル相対の参照も使用できます。 |
results_limit | 任意 | 取得する結果の上限で、1〜2,000を指定できます。省略時のデフォルトは100です。 |
Amazon Product Search API の使い方
対象のストアフロントと具体的な商品フレーズを決めて、非同期リクエストを1件送信します。
- 空でない query を設定し、対応するAmazonの domain URLを指定して、results_limit を1〜2,000の範囲で選びます。
- リクエストを /v1/amazon/product-search に POST し、返された task_id を保存します。
- タスクが succeeded または failed になるまで /v1/tasks/{task_id} をポーリングします。
- 成功したら data.results.items を読み取り、has_more が true の間は next_cursor を渡して続きを取得します。
curl -X POST "https://api.socq.ai/v1/amazon/product-search" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query":"wireless earbuds","domain":"https://www.amazon.com","results_limit":3}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is trueAmazon Product Search API の主なユースケース
- ストアフロントでの商品発見: 対応するAmazonストアフロント1つの中で、カテゴリ、機能、ブランド、購入意図を表すフレーズに一致する公開商品を見つけます。
- 出品条件の比較: 返された商品間で、取得可能な価格、通貨、表示用の価格、セラー情報を比較します。
- 評判のスクリーニング: 取得可能な評価、レビュー数、販売数を確認し、欠けている指標は取得不可として保持します。
- カタログ情報の補完: 商品候補に、正規化されたタイトル、説明文、ソースURL、メディア、セラー、取得日時を補完します。
Amazon Product Search API 活用のヒント
- 同じフレーズでもストアフロントによって結果が異なることがあるため、送信した query と domain を各タスクとあわせて保存してください。
- results_limit は必要な件数に合わせて選んでください。この値で結果の見積もりが予約され、最終的な請求は返されたレコードに基づいて精算されます。
- succeeded のタスクに保存された結果ページが複数ある場合は、has_more が false になるまで next_cursor をたどってください。
- セラー、価格、評価、レビュー数、販売数、メディアの値がない場合は、0や空の情報ではなく取得不可として扱ってください。
関連API
Amazon Product Search API 以外に別の種類の公開Amazonデータが必要な場合は、これらのAPIをご利用ください。
- Amazon Best Sellers API — Amazon売れ筋ランキングの公開カテゴリURLから商品を取得し、正規化されたセラー、価格、評判、販売数、メディア、取得元、タイムスタンプの各フィールドを返します。
- Amazon Product Details API — 既知のAmazon URLから商品詳細を取得し、タイトル、説明、セラー、価格、評価、レビュー数、販売数、メディアの各フィールドを返します。
- Amazon Reviews API — 対応するAmazon URLから、公開商品レビューを本文、評価、投稿者の詳細、商品の参照、タイムスタンプ、メディアとともに取得します。
- Amazon Seller Info API — 既知のセラーURLから、Amazonの公開セラープロフィールのセラー情報、説明、Webサイト、評価、フィードバック、所在地、取得元、取得日時の各フィールドを取得します。
- Amazon Storefront API — ストアURLからAmazonインフルエンサーのストアフロントを読み取り、プロフィール、連携SNS、商品数つきのアイデアリスト、キュレーション投稿、価格つきのトレンド商品を返します。