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を保存して、タスクの成功後に正規化された商品レコードを読み取ります。
- BearerトークンまたはAPIキーを使って、urls 配列を /v1/amazon/product-detail に POST します。
- 返された task_id を保存し、status が succeeded または failed になるまで GET /v1/tasks/{task_id} をポーリングします。
- 成功したら 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 trueAmazon Product Details API の主なユースケース
- 既知アイテムのカタログ情報補完: 既存のAmazon URLのセットに、商品タイトル、説明文、セラー情報、価格、メディア、評価、各種カウントを付与します。
- 特定時点の商品比較: 同時に取得した選択商品のレコード間で、正規化された価格、通貨、評価、レビュー数、販売数、セラーのフィールドを比較します。
- 商品ソースの検証: ID、正規URL、タイトル、説明文、メディアの参照、取得日時を使って、保存しているカタログ参照を公開商品ページと照合します。
Amazon Product Details API 活用のヒント
- 解析したホスト名が対応するAmazonマーケットプレイスに属する商品参照URLを使用してください。ホストが有効であるだけでは、対象が公開商品レコードとして取得できるとは限りません。
- このエンドポイントはプロバイダーの結果上限を送信したURLの件数に固定するため、results_limit は送信しないでください。
- セラー、価格、評価、レビュー数、販売数、メディア、URL、公開日時のフィールドは null を取りうるものとして扱い、アイテムが0件の succeeded タスクもプレースホルダーのデータを作らずにそのまま保持してください。
- next_cursor は保存されたタスク結果をページ送りする場合にのみ使用してください。有料の POST を繰り返すのではなく、同じタスクに対して GET リクエストを続けてください。
関連API
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、商品数つきのアイデアリスト、キュレーション投稿、価格つきのトレンド商品を返します。