amazon/
reviews

対応するURLから公開Amazon商品レビューを取得し、本文、評価、投稿者情報、商品の参照、タイムスタンプ、メディアを正規化されたレコードとして返します。

Amazon Reviews API

複数の商品URL
レビュー本文と評価
投稿者と商品の情報
正規化されたレビューレコード
結果1件あたり0.15クレジット
準備完了
準備完了

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

README

SocQ 編集 · 更新

Amazon Reviews

Amazonの商品レビューは、本文、評価、投稿者情報、投稿日時、商品の参照、添付メディアを含む公開の購入者フィードバックです。これらのレコードは、商品フィードバックの調査、評価の比較、レビューのモニタリング、ソースにリンクしたデータの補完に活用できます。

Amazon Reviews API の主な機能

  • 複数の商品URLを入力対応するAmazon商品URLを1つのタスクで1件以上送信し、保存される正規化レビュー全体に1つの結果上限を適用します。
  • レビュー内容と投稿者各レコードには、公開レビューの本文、数値評価、投稿者情報、投稿日時、添付された画像や動画が保持される場合があります。
  • 商品に紐づいたレコード正規化された結果では、レビューIDとソースリンクに加えて商品IDと商品URLが保持されるため、各レコードがレビュー対象の商品と結びついたままになります。

Amazon Reviews API のパラメータ

パラメータ必須説明
urls必須必須。空でないAmazon商品参照URLのリストです。解析した各ホスト名は、対応するマーケットプレイスまたはそのサブドメインに属している必要があります。ホスト名があればスキームは問わず、プロトコル相対の参照も使用できます。各アイテムがプロバイダーへの入力行1件になります。
results_limit任意タスク全体で保存される正規化レビューの最大件数です。デフォルトは100で、1〜2,000の整数を指定できます。

Amazon Reviews API の使い方

対応する商品URLを送信し、非同期タスクを追跡して、正規化されたレビューレコードをカーソルページネーションで読み取ります。

  1. 対応するAmazon商品URLを1件以上用意し、results_limit を1〜2,000の範囲で決めます。
  2. リクエストを /v1/amazon/reviews に POST し、返された task_id を保存します。
  3. タスクが成功するか失敗を返すまで GET /v1/tasks/{task_id} をポーリングします。
  4. data.results.items を読み取り、has_more が true の間は返された next_cursor を指定して続きを取得します。
curl -X POST "https://api.socq.ai/v1/amazon/reviews" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://www.amazon.com/dp/B0CHHSFMRL"],"results_limit":3}'

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

Amazon Reviews API の主なユースケース

  • 商品フィードバックの調査: レビュー本文、評価、投稿者、投稿日時を使って、既知の商品について返された公開フィードバックを分析します。
  • 商品間の評価比較: 複数の商品URLを送信し、返された評価を subject_id または subject_url でグループ化して、取得したレビューレコードを比較します。
  • レビュー根拠による情報補完: 既存の商品データセットやモニタリングレコードに、ソースリンク、商品の参照、投稿者情報、タイムスタンプ、レビューのメディアを付与します。

Amazon Reviews API 活用のヒント

  • 解析したホスト名が対応するAmazonマーケットプレイスに属する商品参照URLを使用してください。無関係なホスト上の短縮リンクや、対応していない地域のホストは検証に失敗します。
  • results_limit は送信したすべてのURLを通じて保存したいレビューの合計件数に設定し、保存されたすべてのページを読み取るには has_more が false になるまで next_cursor をたどってください。
  • レビューの id がある場合はそれをキーにし、商品ごとにレビューをグループ化する場合は subject_id または subject_url を保持してください。
  • 本文、投稿者フィールド、評価、タイムスタンプ、商品の参照、メディアがない場合は、代わりの値を作らず不明として扱ってください。

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

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

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

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

Amazon Reviews API — よくある質問

Amazon Reviews APIは、対応する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 またはそれらのサブドメインである、空でない urls 配列を送信してください。ホスト名があればスキームは問わず、プロトコル相対の参照も使用できます。

results_limit はタスク全体で保存される正規化レビューの最大件数であり、URLごとの件数を保証するものではありません。返される公開レビューが少ない場合や重複レコードが除去された場合は、より少ない件数でタスクが完了することがあります。

タスクの成功後、data.results.items を読み取り、has_more が true の間はタスクエンドポイントに next_cursor を渡してください。タスク結果エンドポイントのページ limit は1〜500の範囲で指定できます。

正常に保存されたレビュー1件につき0.15 SocQクレジットです。リクエスト時に results_limit に基づいてクレジットが予約され、実際の結果件数で精算されます。結果が空の場合は結果の料金はかかりません。