Amazon Storefront
Amazonストアフロントは、Amazonインフルエンサープログラムに参加するクリエイターが自分のショップ名で運営するページで、商品をアイデアリストやキュレーション投稿にまとめ、紹介文、プロフィール写真、SNSリンク、トレンド商品の一覧も掲載しています。このページを読めば、クリエイターが誰で、ほかにどこで発信しているか、おすすめをどう整理しているか、そしていま何をいくらで推しているかがわかります。
Amazon Storefront API の主な機能
- プロフィールとトップクリエイター表示name、text、avatar_url で表示名、ストアの紹介文、プロフィール写真がわかり、is_top_creator でAmazonがトップクリエイターと表示しているかを確認できます。
- 連携しているSNSアカウントsocial_urls には、ストアのヘッダーからリンクされているTikTok、YouTube、PinterestなどのプロフィールURLが並びます。
- 商品数つきのアイデアリストlists はストア1ページ目のアイデアリストを、タイトル、URL、カバー画像、登録商品数を示す items_count とともに返します。
- キュレーション投稿curations はクリエイターのキュレーション投稿を、タイトル、URL、カバー画像、まとめられた商品数を示す posts_count とともに返します。
- 価格つきのトレンド商品trending_picks はストアがいま目立たせている商品を返し、それぞれにストア内の商品URL、画像、マーケットプレイスの通貨での現在価格、表示中の割引が付きます。
Amazon Storefront API のパラメータ
| パラメータ | 必須 | 説明 |
|---|---|---|
url | 必須 | AmazonインフルエンサーのストアURL。https://www.amazon.com/shop/<name> の形式で、ほかのAmazonマーケットプレイスのストアURLも同じように使えます。 |
Amazon Storefront API の使い方
ストアURLを1件送り、1行の結果としてストア全体を読み取ります。
- /v1/amazon/shop に {"url": "https://www.amazon.com/shop/sydneydelrey"} をPOSTします。
- status が succeeded になるまで GET /v1/tasks/{task_id} をポーリングします。
- results.items からストアを読み取ります。has_more と results.next_cursor は通常のページング規則に従い、この1行の結果では空になります。
curl -X POST "https://api.socq.ai/v1/amazon/shop" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"url":"https://www.amazon.com/shop/sydneydelrey"}'Amazon Storefront API の主なユースケース
- アフィリエイト向けクリエイターの選定: 複数のストアで is_top_creator、アイデアリストの数、items_count を比べ、自社カテゴリの商品を継続的にまとめているクリエイターを絞り込みます。
- おすすめ商品の変化を追う: 同じストアを毎週取得してリスト名、items_count、trending_picks を比べ、どの季節リストが増え、どの商品が前面に出てきたかを把握します。
- ストアとSNSアカウントのひも付け: social_urls を使ってストアをクリエイターのTikTok、YouTube、Pinterestのプロフィールに結び付け、販売活動とSNSでの影響力を1つのレコードで管理します。
Amazon Storefront API 活用のヒント
- trending_picks.price はそのマーケットプレイスの通貨で表示されるため、結果と一緒にドメインも保存してください。
- URLから取ったストア名である id をキーにすると、同じクリエイターを繰り返し取得してもデータがそろいます。
- 個々の商品が必要なときはリストやキュレーション投稿の url を開きます。items_count と posts_count で事前に規模がわかります。
関連API
Amazon Storefront 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 Seller Info API — 既知のセラーURLから、Amazonの公開セラープロフィールのセラー情報、説明、Webサイト、評価、フィードバック、所在地、取得元、取得日時の各フィールドを取得します。