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を送信し、非同期タスクを監視して、正規化された商品レコードをページ送りで取得します。
- 対応するマーケットプレイスのホスト上にある、公開Amazon売れ筋ランキングURLまたはカテゴリリストURLを1件以上用意します。
- urls と任意の results_limit(1〜2,000)を /v1/amazon/best-sellers に送信し、返された task_id を保存します。
- タスクが成功するか失敗を返すまで /v1/tasks/{task_id} をポーリングします。
- 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 trueAmazon 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 を保存し、特定時点の比較が必要な場合は個別に実行をスケジュールしてください。このエンドポイントは継続的なフィードを作成しません。
関連API
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、商品数つきのアイデアリスト、キュレーション投稿、価格つきのトレンド商品を返します。