Amazonインフルエンサープログラムに参加しているクリエイターは、amazon.com/shop/<name>でストアフロントを運営しています。商品をアイデアリストやキュレーション投稿にまとめ、自分のSNSアカウントをリンクし、トレンドピックを目立たせています。アフィリエイトやインフルエンサーのチームにとって、このページは実務上の疑問に答えてくれます。そのクリエイターは誰なのか、ほかにどこで投稿しているのか、今シーズンは何をおすすめしているのか、各リストはどのくらいの規模なのか、といったことです。
2026-11-17、SocQはAmazon Storefront APIを追加しました。1つのストアフロントを、1件の構造化されたレコードとして返します。このガイドでは、リクエスト、フィールド、料金、そしてクリエイターリサーチのワークフローへの組み込み方を説明します。
結論: ストアフロントのURLを1つ
urlに指定して、POST /v1/amazon/shopに送信します。タスクが成功するまでGET /v1/tasks/{task_id}をポーリングし、data.results.itemsから、クリエイターのプロフィール、social_urls、lists、curations、trending_picksを含む1行を読み取ります。1リクエストあたり0.5クレジット($0.0025)です。
エンドポイントが返す内容
1 SocQクレジット = $0.005です。
| エンドポイント | 返される内容 | 料金 |
|---|---|---|
| Amazon Storefront API | ストアフロントごとに1行:クリエイター名、説明文、アバター、トップクリエイターのフラグ、リンクされたSNSプロフィール、アイテム数付きのアイデアリスト、商品数付きのキュレーション投稿、価格付きのトレンドピック | 1回あたり0.5クレジット($0.0025) |
この行には、ストアフロントのリスト、キュレーション、トレンドピックの最初のページが含まれます。存在しないストアフロントは返金付きで失敗するため、無効なURLに対して課金されることはありません。
認証と非同期タスクの流れ
SocQのリクエストはすべてAPIキーで認証します。送信、タスクのステータス確認、結果の取得のいずれにも同じヘッダーを使います。
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
収集はすべてバックグラウンドのタスクとして実行されます。
submit -> task_id -> queued -> running -> succeeded
\-> failed
送信のレスポンスにはdata.task_idとdata.statusが含まれます。そのIDでタスクをポーリングします。
curl "https://api.socq.ai/v1/tasks/$TASK_ID?limit=50" \
-H "Authorization: Bearer $SOCQ_API_KEY"
statusがsucceededになると、レスポンスのdata.results.itemsに正規化されたレコードの最初のページが含まれます。limitのデフォルトは50で、最大500まで指定できます。has_moreがtrueなら、results.next_cursorをcursorとして渡します。タスクがqueued、running、failedの間は、エンドポイントはresultsなしでタスクのメタデータを返します。
送信ボディに任意のcallback_urlを指定すると、タスクの完了時にSocQがタスクの概要を1回POSTします。レコードはGET /v1/tasks/{task_id}で読み取ってください。クライアント側でタイムアウトしてもタスクはキャンセルされないため、重複して支払わないよう、同じタスクIDで再開してください。402はクレジット不足、429はキーがレート制限またはクレジットの上限に達したことを意味します。
ストアフロントをリクエストする
入力はurlだけで、amazon.com/shop/<name>形式のストアフロントを1つ指定します。ほかのAmazonマーケットプレイスでも同じように動作します。
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"
}'
このエンドポイントは、1リクエストにつき1つのURLを受け取ります。複数のストアフロントを読み取るには、URLごとに1つのタスクを送信し、それぞれのtask_idを入力とともに保存して、個別にポーリングしてください。
ストアフロントのレコードを理解する
ドキュメントの例から一部を抜粋した結果は、次のとおりです。
{
"id": "sydneydelrey",
"platform": "amazon",
"resource": "shop",
"type": "storefront",
"url": "https://www.amazon.com/shop/sydneydelrey",
"name": "sydney del rey",
"is_top_creator": true,
"social_urls": [
"https://vm.tiktok.com/ZTFrowSpg/",
"https://www.youtube.com/channel/UCWvW1JOQ-nsAinO1jLFgrVA",
"https://www.pinterest.com/sydneydelrey"
],
"lists": [
{
"title": "Holiday home goods",
"url": "https://www.amazon.com/shop/sydneydelrey/list/XYAIGEFWJGML?tag=sydneybertonc-20",
"items_count": 107
}
],
"curations": [
{
"title": "f/w fit try ons",
"url": "https://www.amazon.com/shop/sydneydelrey/curation/71fad634-5787-4ee1-bc3c-6e3ca23e5eae",
"posts_count": 109
}
],
"trending_picks": [
{
"url": "https://www.amazon.com/shop/sydneydelrey/getProductDetails/B0FCLQD6BN?showRelatedPost=true&tag_override=sydneybertonc-20",
"price": 24.99,
"discount": null
}
]
}
フィールドを用途別にまとめると、次のとおりです。
- クリエイターの基本情報:
id(URLに含まれるストアフロント名)、name、text(クリエイターが書いた説明文)、avatar_url、そしてAmazonがそのクリエイターをトップクリエイターとして扱っているかを示すis_top_creator。 - プラットフォームをまたいだリーチ:
social_urls。ストアフロントにリンクされているSNSプロフィールです。 - カタログの構成:
title、url、image_url、items_countを持つlistsと、title、url、image_url、posts_count(キュレーション投稿に含まれる商品数)を持つcurations。 - 現在のプロモーション:
url、image_url、マーケットプレイスの通貨でのprice、表示されている場合はdiscountを持つtrending_picks。
すべての行には、SocQが収集した日時を示すcollected_atも含まれます。価格は変わるため、保存する価格にはこのタイムスタンプも一緒に記録してください。フィールドの一覧はAmazon Storefrontのドキュメントに掲載しています。
使いどころ
アフィリエイトパートナーの発掘。 is_top_creator、リストの数、各リストのitems_countを見れば、チームの誰かがページを開く前に、そのストアフロントがどの程度活発かをすばやく把握できます。
クリエイターのおすすめを追跡する。 ストアフロントを定期的に読み取り、実行ごとにリストのタイトル、件数、トレンドピックを比較すれば、そのクリエイターが今シーズン何を推しているかが分かります。
ストアフロントとクリエイターのSNSアカウントを結びつける。 social_urlsから、クリエイターがリンクしているTikTok、YouTube、Pinterestのプロフィールが得られます。これをCreator APIに渡せば公開されているビジネス用メールアドレスを探せますし、各プラットフォームのプロフィール用エンドポイントに渡せばフォロワー数を取得できます。
商品リサーチ。 トレンドピックは商品を指しています。商品の詳細データ、レビュー、カテゴリランキングを取得するには、Amazon Product Details APIやAmazon Best Sellers APIなど、SocQのほかのAmazonエンドポイントを使ってください。これらとAmazon自身のAPIとの比較については、Amazon Product Advertising APIの代替サービスをご覧ください。
本番運用のヒント
- URLを正規化する。 同じストアフロントに二重に支払わないよう、クリエイターごとに
amazon.com/shop/<name>の正規の形を1つに決めておきます。 - 最初のページのスナップショットだと考える。 リスト、キュレーション、トレンドピックは、ストアフロントの最初のページに表示されているものです。件数は
collected_at時点のスナップショットとして扱ってください。 - 失敗は別に処理する。 存在しないストアフロントは返金付きで失敗します。リトライせず、消えたものとして記録してください。
- 予算はシンプルに見積もる。 ストアフロント1件あたり0.5クレジットなので、1,000件で500クレジット、つまり$2.50です。
よくある質問(FAQ)
Amazon Storefront APIとは何ですか?
Amazonのクリエイターストアフロント(amazon.com/shop/<name>)を1つ読み取り、クリエイターのプロフィール、リンクされたSNS、アイデアリスト、キュレーション投稿、トレンドピックを1件の構造化されたレコードとして返すSocQのエンドポイントです。
amazon.com以外でも使えますか?
はい。ドキュメントには、ほかのAmazonマーケットプレイスでも同じように動作すると記載されています。そのマーケットプレイスのストアフロントURLをurlに指定してください。trending_picksの価格は、そのマーケットプレイスの通貨で表示されます。
すべてのリストのすべての商品が返されますか?
いいえ。この行には、ストアフロントの最初のページが含まれます。各リストのタイトル、URL、カバー画像、items_count、各キュレーション投稿の商品数、そして現在のトレンドピックです。リスト内のすべてのアイテムを展開するわけではありません。
ストアフロントが存在しない場合も課金されますか?
いいえ。存在しないストアフロントは返金付きで失敗します。成功したリクエストは0.5クレジット($0.0025)です。
1回のリクエストで複数のストアフロントを送れますか?
リクエストが受け取るのは1つのurlだけです。ストアフロントごとに1つのタスクを送信し、それぞれのtask_idを追跡してください。