amazon/
best-sellers

公開Amazon売れ筋ランキングのURLから商品を取得し、タイトル、セラー情報、価格、表示中の評判指標、メディアを正規化されたレコードとして返します。

Amazon Best Sellers API

カテゴリURLで指定
商品レコード
結果1件あたり0.15クレジット
結果1件あたり0.15クレジット
準備完了
準備完了

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

README

SocQ 編集 · 更新

Amazon Best Sellers

Amazon売れ筋ランキングのページは、公開されている商品をカテゴリ別のリストにまとめたもので、公開されている場合は商品タイトル、セラー情報、価格、評価、レビュー数、販売数、メディア、ソースリンク、観測日時を取得できます。SocQは選択したリストのURLを正規化された商品レコードに変換し、カテゴリ調査、品揃えの比較、繰り返し実行するコマースデータのワークフローに活用できるようにします。

Amazon Best Sellers API の主な機能

  • 地域別カテゴリURLからの取得対応するAmazonマーケットプレイスの公開売れ筋ランキングURLまたはカテゴリリストURLを1件以上、1つの非同期タスクで送信できます。
  • 正規化された商品情報取得可能なID、タイトル、説明文、ソースURL、プラットフォームとリソースのラベル、取得日時を含む安定した商品レコードを受け取れます。
  • コマースと評判の情報取得可能なセラーの詳細、価格、評価、レビュー数、販売数を、ページのマークアップを解析することなく明示的なフィールドで保持します。
  • メディアをそのまま使える商品レコード各商品に付く正規化されたメディアオブジェクトを、カタログ、レビュー待ちリスト、情報補完パイプライン、下流の画像分析に活用できます。

Amazon Best Sellers API のパラメータ

パラメータ必須説明
urls必須必須。対応するマーケットプレイスのホストまたはそのサブドメイン上にあるAmazonの参照URLのリストです。各パスには /zgbs/ または /gp/bestsellers/ が含まれている必要があります。ホスト名を解析できるURLであればスキームは問わず、プロトコル相対の参照も使用できます。
results_limit任意任意。1〜2,000の整数です。デフォルトは100で、送信したすべてのURLを通じて保存される重複のない商品レコードの合計件数の上限になります。

Amazon Best Sellers API の使い方

既知の公開売れ筋ランキングURLを送信し、非同期タスクを監視して、正規化された商品レコードをページ送りで取得します。

  1. 対応するマーケットプレイスのホスト上にある、公開Amazon売れ筋ランキングURLまたはカテゴリリストURLを1件以上用意します。
  2. urls と任意の results_limit(1〜2,000)を /v1/amazon/best-sellers に送信し、返された task_id を保存します。
  3. タスクが成功するか失敗を返すまで /v1/tasks/{task_id} をポーリングします。
  4. data.results.items を読み取り、has_more が true の間は next_cursor を指定して続きを取得します。
curl -X POST "https://api.socq.ai/v1/amazon/best-sellers" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://www.amazon.com/Best-Sellers-Books/zgbs/books"],"results_limit":3}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is true

Amazon Best Sellers API の主なユースケース

  • カテゴリの品揃えスナップショット: 選択した売れ筋ランキングページを、ソースリンクと取得日時付きの上限のある商品一覧に変換し、特定の調査用データセットを作成します。
  • 価格と評判の比較: 下流で不統一なページのマークアップをスクレイピングすることなく、返された商品間で取得可能な価格、評価、レビュー数、販売数を比較します。
  • 商品発見後の情報補完: カテゴリページから見つけた候補リストに、タイトル、セラー情報、説明文、メディア、公開商品URLを追加します。

Amazon Best Sellers API 活用のヒント

  • パスに /zgbs/ または /gp/bestsellers/ を含む、対応する地域別Amazonホスト上の参照URLを使用してください。無関係なAmazonのパスはタスク作成前に拒否されます。
  • results_limit は送信したURLごとではなくタスク全体に対して設定されるため、必要なバッチ全体の件数に合わせて設定してください。
  • タスク結果はカーソルページネーション付きの別の結果ビューで返されるため、has_more が false になるまで next_cursor をたどってください。
  • ID、説明文、セラーデータ、価格、評価、各種カウント、メディア、URL、公開日時は null を取りうるものとして扱い、欠けている値を0や空のオブジェクトで置き換えないでください。
  • 各レコードに collected_at を保存し、特定時点の比較が必要な場合は個別に実行をスケジュールしてください。このエンドポイントは継続的なフィードを作成しません。

Amazon Best Sellers API 以外に別の種類の公開Amazonデータが必要な場合は、これらのAPIをご利用ください。

  • Amazon Product Details API — 既知のAmazon URLから商品詳細を取得し、タイトル、説明、セラー、価格、評価、レビュー数、販売数、メディアの各フィールドを返します。
  • Amazon Product Search API — 対応するAmazonストアを商品フレーズで検索し、商品、セラー、価格、評価、レビュー、販売数、メディア、取得元の各フィールドを、取得可能な範囲で正規化して返します。
  • Amazon Reviews API — 対応するAmazon URLから、公開商品レビューを本文、評価、投稿者の詳細、商品の参照、タイムスタンプ、メディアとともに取得します。
  • Amazon Seller Info API — 既知のセラーURLから、Amazonの公開セラープロフィールのセラー情報、説明、Webサイト、評価、フィードバック、所在地、取得元、取得日時の各フィールドを取得します。
  • Amazon Storefront API — ストアURLからAmazonインフルエンサーのストアフロントを読み取り、プロフィール、連携SNS、商品数つきのアイデアリスト、キュレーション投稿、価格つきのトレンド商品を返します。

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

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

Amazon Best Sellers API — よくある質問

Amazon Best Sellers APIは、公開Amazon売れ筋ランキングURLまたはカテゴリリストURLから商品を取得し、正規化されたSocQの商品レコードとして返すプログラムインターフェースです。

urls 配列には、解析したホスト名が対応するAmazonマーケットプレイスまたはそのサブドメインで、パスに /zgbs/ または /gp/bestsellers/ を含む参照URLを指定できます。ホスト名があればスキームは問わず、プロトコル相対の参照も使用できます。

安定した商品レスポンスには順位のフィールドは含まれません。正規化レコードは、取得可能な場合の商品情報、コンテンツ、セラー、価格、評価、レビュー数と販売数、メディア、URL、タイムスタンプを中心に構成されています。

results_limit のデフォルトは100で、1〜2,000の整数を指定できます。すべての入力URLを通じてタスクで保存される重複のないレコードの合計件数の上限であり、URLごとに個別の枠が設けられるわけではありません。

/v1/tasks/{task_id} をポーリングし、成功後に data.results.items を読み取ります。has_more が true の間は、返された next_cursor を指定してリクエストを続けてください。結果ページの limit は取得時のページネーションを制御するもので、収集件数を制御するものではありません。

公開状況、ページの内容、プロバイダーの出力、正規化、重複除外、タスク全体に適用される results_limit のいずれによっても、最終的な結果件数は少なくなることがあります。成功したタスクに商品レコードが1件も含まれない場合もあります。

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