amazon/
product-search

対応するAmazonストアフロントを商品フレーズで検索し、正規化された商品、セラー、価格、評価、レビュー数、販売数、メディアのフィールドを取得します。

Amazon Product Search API

商品検索
ストアフロントの指定
正規化されたレコード
結果1件あたり0.15クレジット
準備完了
準備完了

パラメータを入力してリクエストを送信してください。タスクのステータスと正規化された結果がここに表示されます。

README

SocQ 編集 · 更新

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件送信します。

  1. 空でない query を設定し、対応するAmazonの domain URLを指定して、results_limit を1〜2,000の範囲で選びます。
  2. リクエストを /v1/amazon/product-search に POST し、返された task_id を保存します。
  3. タスクが succeeded または failed になるまで /v1/tasks/{task_id} をポーリングします。
  4. 成功したら 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 true

Amazon Product Search API の主なユースケース

  • ストアフロントでの商品発見: 対応するAmazonストアフロント1つの中で、カテゴリ、機能、ブランド、購入意図を表すフレーズに一致する公開商品を見つけます。
  • 出品条件の比較: 返された商品間で、取得可能な価格、通貨、表示用の価格、セラー情報を比較します。
  • 評判のスクリーニング: 取得可能な評価、レビュー数、販売数を確認し、欠けている指標は取得不可として保持します。
  • カタログ情報の補完: 商品候補に、正規化されたタイトル、説明文、ソースURL、メディア、セラー、取得日時を補完します。

Amazon Product Search API 活用のヒント

  • 同じフレーズでもストアフロントによって結果が異なることがあるため、送信した query と domain を各タスクとあわせて保存してください。
  • results_limit は必要な件数に合わせて選んでください。この値で結果の見積もりが予約され、最終的な請求は返されたレコードに基づいて精算されます。
  • succeeded のタスクに保存された結果ページが複数ある場合は、has_more が false になるまで next_cursor をたどってください。
  • セラー、価格、評価、レビュー数、販売数、メディアの値がない場合は、0や空の情報ではなく取得不可として扱ってください。

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、商品数つきのアイデアリスト、キュレーション投稿、価格つきのトレンド商品を返します。

他のプラットフォームを見る

Amazonのデータを、対応する他のソーシャルプラットフォームの公開データと組み合わせられます。

Amazon Product Search API — よくある質問

Amazon Product Search APIは、対応するAmazonストアフロント1つを商品クエリで検索し、正規化された公開商品レコードを非同期タスクのワークフローで返すAPIです。

ランタイムは解析したホスト名をチェックし、amazon.com、amazon.co.uk、amazon.de、amazon.fr、amazon.es、amazon.it、amazon.ca、amazon.com.au、amazon.in、amazon.co.jp とそのサブドメインを受け付けます。ホスト名があればスキームは問わず、プロトコル相対の参照も使用できます。

query と domain は必須の空でない文字列です。results_limit は任意で、デフォルトは100、1〜2,000の整数である必要があります。

商品には、ID、プラットフォーム、リソース、種別、ソースURL、公開日時と取得日時、タイトル、説明文、セラー、価格、評価、レビュー数、販売数、メディアが含まれる場合があります。null を取りうるフィールドは、ソースが利用可能な値を提供している場合にのみ含まれます。

results_limit は上限です。公開ソースに一致するレコードがそれ以上ない場合は取得が早めに終了するため、成功したタスクでも商品が少ない、または0件になることがあります。

/v1/tasks/{task_id} をポーリングし、成功後に data.results.items を読み取ります。has_more が true の間は next_cursor でタスク結果の次のページをリクエストしてください。

正常に返された正規化商品1件につき0.15 SocQクレジットです。リクエスト時に results_limit(省略時は100)に基づいて予約され、実際の結果件数で精算されたうえで、使われなかったクレジットは返金されます。結果が空の場合は結果の料金はかかりません。