amazon/
product-detail

既知のURLから公開Amazon商品の詳細を取得し、タイトル、説明文、セラー、価格、評価、レビュー数と販売数、メディアを正規化されたレコードとして返します。

Amazon Product Details API

既知の商品URL
複数マーケットプレイスに対応
正規化された商品レコード
結果1件あたり0.15クレジット
準備完了
準備完了

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

README

SocQ 編集 · 更新

Amazon Product Details

Amazonの商品は、ID、タイトル、説明文、セラー情報、価格、評価、レビュー数、販売数、メディアで構成される公開カタログのアイテムです。これらのフィールドは、カタログ情報の補完、アイテムの比較、ソースの検証、特定時点の商品レポートに活用できます。

Amazon Product Details API の主な機能

  • 既知の商品URLの一括取得1つのタスクで1件以上のAmazon URLを送信でき、返される正規化商品レコードは指定した有効なURLの件数を超えません。
  • 商品情報・説明文・メディア各レコードには、商品IDとURL、タイトル、説明文、取得日時、取得可能な画像や動画の参照が含まれる場合があります。
  • セラー・価格・表示中の商品指標ネストされたセラーと価格のオブジェクトが、評価、レビュー数、公表されている販売数のフィールドと並んで返されるため、フィールド単位で一貫した処理が可能です。
  • 対応するAmazonマーケットプレイスのホストURLの検証では、米国、英国、ドイツ、フランス、スペイン、イタリア、カナダ、オーストラリア、インド、日本のAmazonホストとそのサブドメインを受け付けます。

Amazon Product Details API のパラメータ

パラメータ必須説明
urls必須必須。既知の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 またはそのサブドメインである必要があります。ホスト名があればスキームは問わず、プロトコル相対の参照も使用できます。

Amazon Product Details API の使い方

既知の商品URLを送信し、非同期タスクのIDを保存して、タスクの成功後に正規化された商品レコードを読み取ります。

  1. BearerトークンまたはAPIキーを使って、urls 配列を /v1/amazon/product-detail に POST します。
  2. 返された task_id を保存し、status が succeeded または failed になるまで GET /v1/tasks/{task_id} をポーリングします。
  3. 成功したら data.results.items を読み取ります。has_more が true の場合は、商品タスクを再送信せずに next_cursor で次の結果ページをリクエストします。
curl -X POST "https://api.socq.ai/v1/amazon/product-detail" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://www.amazon.com/dp/B0CHHSFMRL"]}'

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

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

  • 既知アイテムのカタログ情報補完: 既存のAmazon URLのセットに、商品タイトル、説明文、セラー情報、価格、メディア、評価、各種カウントを付与します。
  • 特定時点の商品比較: 同時に取得した選択商品のレコード間で、正規化された価格、通貨、評価、レビュー数、販売数、セラーのフィールドを比較します。
  • 商品ソースの検証: ID、正規URL、タイトル、説明文、メディアの参照、取得日時を使って、保存しているカタログ参照を公開商品ページと照合します。

Amazon Product Details API 活用のヒント

  • 解析したホスト名が対応するAmazonマーケットプレイスに属する商品参照URLを使用してください。ホストが有効であるだけでは、対象が公開商品レコードとして取得できるとは限りません。
  • このエンドポイントはプロバイダーの結果上限を送信したURLの件数に固定するため、results_limit は送信しないでください。
  • セラー、価格、評価、レビュー数、販売数、メディア、URL、公開日時のフィールドは null を取りうるものとして扱い、アイテムが0件の succeeded タスクもプレースホルダーのデータを作らずにそのまま保持してください。
  • next_cursor は保存されたタスク結果をページ送りする場合にのみ使用してください。有料の POST を繰り返すのではなく、同じタスクに対して GET リクエストを続けてください。

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

  • Amazon Best Sellers 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 Product Details API — よくある質問

Amazon Product Details APIは、既知のAmazon参照URLから公開商品の詳細を取得するプログラムインターフェースです。正規化されたID、タイトル、説明文、セラーと価格のオブジェクト、評価、レビュー数と販売数、メディア、取得に関するメタデータを返します。

Amazon商品URLを含む空でない urls 配列を送信してください。ランタイムは、米国、英国、ドイツ、フランス、スペイン、イタリア、カナダ、オーストラリア、インド、日本のAmazonホストとそのサブドメインを受け付けます。

できます。urls 配列に既知のURLを複数追加してください。プロバイダーの結果上限は送信したURLの件数と同じで、無効な行、利用できない行、エラーの行があると成功した結果の件数は少なくなることがあります。

安定した商品スキーマには、IDとソースのフィールド、タイトル、説明文、ネストされたセラーと価格のオブジェクト、評価、レビュー数、公表されている販売数、メディア、タイムスタンプが含まれます。ソース側で取得できない任意の値は null のままになります。

ページネーションは、商品URLを送信するときではなく、タスクの成功後に保存された結果を読み取るときに適用されます。has_more が true の間のみ、GET /v1/tasks/{task_id} で next_cursor をたどってください。

リクエスト時に送信したURL 1件あたり0.15クレジットの見積もりが予約され、正常に返された商品レコード1件あたり0.15クレジットで精算されます。基本料金が0クレジットで、空の結果には基本料金のみが適用されるポリシーのため、レコードが返らなかったタスクの精算額は0になります。