API一覧に戻る
Amazonの公開コマースデータ

Amazon公開データAPI

対応するマーケットプレイスで公開Amazon商品を検索し、正規化された商品詳細、売れ筋ランキング、レビュー、セラーのプロフィール、クリエイターのストアフロントのレコードを取得できます。

利用できるAmazon API

公開Amazonのワークフローに応じて、Product Search、Product Detail、Best Sellers、Reviews、Seller Info、Storefrontを使用します。

取得できるAmazonデータ

SocQは対応する公開Amazonの入力から正規化された商品、レビュー、セラー、クリエイターのストアフロントのレコードを返します。取得元が利用可能な値を提供しないフィールドは null のまま保持します。

商品の基本情報とコンテンツ

取得可能な商品ID、タイトル、説明文、公開URL、プラットフォームとリソースのラベル、取得日時を取得します。

セラーと価格のコンテキスト

値が取得可能な場合、正規化されたセラーのオブジェクトと価格を、見つかった各商品とあわせて保持します。

表示中の評判シグナル

取得可能な評価、レビュー数、販売数を特定時点の公開観測値として利用でき、欠けている値を0として扱うことはありません。

商品のメディア

正規化されたメディアオブジェクトを受け取り、商品カタログ、確認キュー、後続の画像処理に活用できます。

クリエイターのストアフロント

Amazonインフルエンサーのストアのプロフィール、連携SNS、商品数つきのアイデアリスト、キュレーション投稿、価格つきのトレンド商品を取得します。

SocQとページを直接処理する方法の比較

SocQは、対応する公開Amazonデータについて、認証付きのタスクワークフローと標準の結果スキーマを提供します。ページを直接処理する場合、リクエストの制御、解析、保存、ページネーション、スキーマの保守はアプリケーション側で行う必要があります。

機能SocQページの直接処理
入力の起点検索語または対応する公開AmazonのURLページURLとアプリケーション固有の取得ロジック
実行モデルステータスをポーリングする非同期タスクアプリケーション側で定義・運用
商品データの形式正規化された商品レコードページ固有のマークアップと独自の解析
保存済み結果へのアクセスカーソルでページ分割されたアイテムアプリケーションが管理する保存とページネーション

Amazon APIの仕組み

Amazonのエンドポイントでは、非同期タスクの後に、カーソルでページ分割された結果を取得します。

  1. 1. エンドポイントの入力を送信

    選択したエンドポイントで必要な検索語、商品URL、カテゴリURL、セラーURL、ストアURLを送信し、task_id を保存します。

  2. 2. 処理を追跡

    処理が成功するかタスクが失敗を報告するまで、/v1/tasks/{task_id} をポーリングします。

  3. 3. 商品を取得

    data.results.items を読み取り、has_more が true の間は next_cursor をたどって、保存されたすべてのレコードを取得します。

売れ筋ランキングのページから商品を取得

SocQのAPIキーで認証し、公開カテゴリ一覧のURLを送信して、非同期タスクから商品の結果を取得します。

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-Electronics/zgbs/electronics"],"results_limit":3}'

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

Amazon APIの主なユースケース

カテゴリの品揃え調査

特定のカテゴリ調査用に、選んだ売れ筋ランキングのページに表示されている商品の上限付きスナップショットを作成します。

候補商品リストの情報補完

選んだカテゴリページで見つかった商品に、タイトル、説明文、セラーのコンテキスト、価格、メディア、公開リンクを追加します。

コマースシグナルの比較

取得日時を保持しながら、正規化された商品間で取得可能な価格、評価、レビュー数、販売数を比較します。

アフィリエイト向けクリエイター調査

トップクリエイター表示、アイデアリスト、商品数、トレンド商品でクリエイターのストアを比べ、アフィリエイトの提携候補を絞り込みます。

制限事項と公開データポリシー

Amazonの結果は、対応する公開ページから得た特定時点のレコードです。このAPIは、顧客アカウント、非公開データ、カート、注文、在庫システム、セラー管理機能にはアクセスしません。

  • 対応するホストは amazon.com、amazon.co.uk、amazon.de、amazon.fr、amazon.es、amazon.it、amazon.ca、amazon.com.au、amazon.in、amazon.co.jp と、それらのサブドメインです。
  • 公開されている売れ筋ランキングまたはカテゴリ一覧のページを使用してください。ホストの検証を通過しても、関係のないAmazonのページに対応する商品リストが含まれているとは限りません。
  • results_limit のデフォルトは100で、1〜2,000を指定でき、タスク内のすべてのURLを通じて保存される重複のない結果の総数の上限になります。
  • 安定したレスポンスには、売れ筋ランキングの順位フィールドは含まれません。
  • 利用可能な公開値がない場合、商品ID、コンテンツ、セラー、価格、評価、各種数値、メディア、URL、公開日時は null になることがあります。

Amazon APIに関するよくある質問

Amazon APIとは何ですか?

Amazon APIは、対応する公開Amazonの入力から商品を検索し、正規化された商品、レビュー、セラー、クリエイターのストアフロントのレコードを取得するAPIです。

どのAmazonエンドポイントを利用できますか?

Product Search、Product Detail、Best Sellers、Reviews、Seller Info、Storefrontを、共通の非同期タスクワークフローで利用できます。

複数のカテゴリURLを取得できますか?

はい。1つのタスクで複数のURLを送信できます。ただし、results_limit はURLごとの上限ではなく、タスク全体で共有される合計の上限である点に注意してください。

SocQは商品の順位を返しますか?

いいえ。順位は安定した商品スキーマには含まれません。取得可能な基本情報、セラー、価格、評判、販売数、メディア、取得元、タイムスタンプのフィールドを使用してください。

Amazon商品のフィールドが欠けることはありますか?

はい。標準の商品フィールドは null を許容しており、公開レコードが利用可能な値を提供しない場合は欠けたままになります。

Best Sellersエンドポイントの料金はどのように計算されますか?

正常に返された標準商品は1件あたり0.15クレジットです。結果が空の場合、結果に対する料金は発生せず、タスクの確定時に使われなかった事前課金のクレジットは返金されます。

さまざまなプラットフォームの公開プロフィール、コンテンツ、エンゲージメントデータを1つのワークフローに集約し、ブランド、クリエイター、トピックの追跡やクロスプラットフォームのモニタリング・分析をより効率的に行えます。

Apple App Store API

既知のストアURLから、公開Apple App Storeのアプリ詳細、カテゴリランキング、レビューを、正規化されたアプリとレビューのレコードとして取得できます。

SEO API

Googleのオーガニック検索結果をリアルタイムで取得し、キーワードの需要と順位獲得の難易度を比較し、シードキーワードを拡張し、サイトの検索での可視性を支えるキーワードとページを明らかにし、検索意図を分類できるほか、Googleニュース・画像・サジェスト、Bing、YouTubeの結果も集められます。すべてのエンドポイントで、共通のSocQのAPIキー、非同期タスクフロー、正規化された結果形式を使用します。

Telegram API

t.meリンクから公開Telegramチャンネルを読み取ります。登録者数付きのチャンネル情報、閲覧数とリアクション付きの投稿、個別の投稿、ディスカッショングループのコメント、類似チャンネル、全履歴の検索に対応します。

Link in Bio API

クリエイターがInstagram、TikTok、YouTubeのプロフィール欄に置く1本のリンクを、表示名、紹介文、アイコン、掲載されている連絡先メール、連携SNS、各ボタンのタイトルとリンク先という構造化データに変えます。

Creator API

Instagram、TikTok、YouTube、X、Facebook、Threadsのプロフィール1件を起点に、クリエイターの公開ビジネスメール、ほかのSNSのアカウント、プロフィール写真からの年齢・性別の推定を取得します。

Google Hotels API

目的地でホテルを検索し、任意のホテルのGoogleホテル上のプロフィールと1泊料金カレンダーを取得します。3つはすべて同じホテルIDでつながります。