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を送信し、非同期タスクを追跡して、正規化されたレビューレコードをカーソルページネーションで読み取ります。
- 対応するAmazon商品URLを1件以上用意し、results_limit を1〜2,000の範囲で決めます。
- リクエストを /v1/amazon/reviews に POST し、返された task_id を保存します。
- タスクが成功するか失敗を返すまで GET /v1/tasks/{task_id} をポーリングします。
- 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 trueAmazon 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 を保持してください。
- 本文、投稿者フィールド、評価、タイムスタンプ、商品の参照、メディアがない場合は、代わりの値を作らず不明として扱ってください。
関連API
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、商品数つきのアイデアリスト、キュレーション投稿、価格つきのトレンド商品を返します。