amazon/
seller-info

既知の公開AmazonセラープロフィールURLから、正規化されたセラー情報、説明文、ウェブサイト、評価、フィードバック、所在地、ソース、取得日時のフィールドを取得します。

Amazon Seller Info API

セラープロフィールの詳細
対応マーケットプレイス
URLごとに1レコード
結果1件あたり0.15クレジット
準備完了
準備完了

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

README

SocQ 編集 · 更新

Amazon Seller Info

Amazonのセラープロフィールページでは、セラー名、公開されている説明文、評価、フィードバックの総数、ウェブサイト、所在地の情報が公開されていることがあります。SocQは既知のセラーURLについて取得可能な公開フィールドを安定したセラースキーマで取得し、非公開、未掲載、マーケットプレイス固有、または取得できない値は推測せずに null のままにします。

Amazon Seller Info API の主な機能

  • 既知のセラーURLからの取得米国、英国、EU、カナダ、オーストラリア、インド、日本を含む10の対応Amazonマーケットプレイスから、公開セラープロフィールURLを1件以上送信できます。
  • 安定したセラー情報セラーID、公開URL、セラー名または事業者名、説明文、関連ウェブサイト、取得日時を1つの固定された結果形式で受け取れます。
  • 公開されている評判指標Amazonが公開している場合はソースが報告する rating と feedback_count の値を保持し、欠けている値の計算や補完は行いません。
  • マーケットプレイスの所在地情報取得可能な所在地名、市区町村、地域、国、緯度、経度のフィールドを保存し、任意の所在地の値はすべて null のままにできます。

Amazon Seller Info API のパラメータ

パラメータ必須説明
urls必須必須。公開Amazonセラー参照URLの空でない配列です。解析したホスト名は、対応するマーケットプレイスまたはそのサブドメインに属している必要があります。ホスト名があればスキームは問わず、プロトコル相対の参照も使用できます。この詳細取得ではセラープロフィールのパスを使用してください。

Amazon Seller Info API の使い方

公開AmazonセラープロフィールURLを送信し、非同期タスクを追跡して、ページネーション付きのタスク結果から正規化されたセラーレコードを読み取ります。

  1. 対応するマーケットプレイスから、公開AmazonセラープロフィールURLを1件以上コピーします。
  2. urls 配列を /v1/amazon/seller-info に POST し、返された task_id を保存します。
  3. タスクが成功または失敗するまで /v1/tasks/{task_id} をポーリングします。
  4. data.results.items を読み取り、has_more が true の場合のみ next_cursor をたどります。
curl -X POST "https://api.socq.ai/v1/amazon/seller-info" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://www.amazon.com/sp?seller=A2L77EE7U53NWQ"]}'

# Poll GET /v1/tasks/{task_id}
# Read normalized sellers from data.results.items

Amazon Seller Info API の主なユースケース

  • セラー情報のマッピング: 用意したセラープロフィールURLのリストを、一貫したセラーID、名前、公開URL、ウェブサイト、マーケットプレイス情報に変換します。
  • 評判のスナップショット: 公開されている評価、フィードバックの総数、collected_at の日時を記録し、値をリアルタイムのフィードとみなさずに特定時点の比較を繰り返し行えるようにします。
  • マーケットプレイスのサプライヤー審査: 公開されているセラーの説明文、ウェブサイト、所在地、フィードバック指標をソースのプロフィールURLに紐づけたまま、審査用のリストを作成します。

Amazon Seller Info API 活用のヒント

  • /sp?seller={seller_id} のような正規のセラープロフィールリンクを送信してください。商品ページや検索ページはホストのルールを通過しますが、セラー詳細の入力にはなりません。
  • results_limit は送信しないでください。バックエンドはURLごとに1件の詳細入力を作成し、保存される結果を送信した空でないURLの件数までに制限します。
  • 受け付けられた1件のURLから返されるセラーレコードは0件または1件です。そのため、ページが存在しない、または利用できない場合は result_count がURLの件数より少なくなることがあります。
  • rating と feedback_count はソースが報告したスナップショットとして扱い、繰り返し取得したデータを比較する場合は collected_at を使用してください。
  • 所在地のフィールドとウェブサイトは任意項目です。null の値や公開プロフィールの値から、法的な拠点、所有者、認証の有無を推測しないでください。

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

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

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

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

Amazon Seller Info API — よくある質問

Amazon Seller Info APIは、公開されているAmazonセラープロフィールのフィールドをURLベースで取得し、正規化されたセラースキーマにまとめるインターフェースです。Seller Centralの非公開アカウントデータにはアクセスしません。

ランタイムの検証では、米国、英国、ドイツ、フランス、スペイン、イタリア、カナダ、オーストラリア、インド、日本のAmazonホストとそのサブドメインを受け付けます。

いいえ。送信した空でないURLはそれぞれ1件の詳細入力となり、保存されるセラーレコードは最大1件ですが、利用できないページ、プロバイダー側で無効なページ、空のページではレコードが返らないことがあります。

使いません。results_limit はリクエストフィールドとして受け付けられず、プロバイダーにはURLごとに1件の詳細行が渡されます。ただし、タスク結果エンドポイントでは limit と next_cursor で保存済みアイテムをページ送りできます。

正常に返されたセラーレコード1件につき0.15 SocQクレジットです。リクエスト時に送信したURL 1件あたり0.15クレジットが予約され、実際の result_count で精算されます。成功して結果が空の場合は0クレジットの基本料金のみがかかり、使われなかった予約分は返金されます。