AmazonAmazon StorefrontAmazon Influencerпартнерский маркетингруководство по API

Amazon Storefront API: витрины авторов, идеи-списки и трендовые товары

Получайте витрину автора Amazon одним API-запросом: профиль, связанные соцсети, идеи-списки с числом товаров, подборки и трендовые товары с ценами, за 0.5 кредита.

SocQОбновлено 19 ноября 2026 г.5 мин чтения

Авторы из программы Amazon Influencer ведут витрину по адресу amazon.com/shop/<name>. Они группируют товары в идеи-списки и подборки, привязывают свои аккаунты в соцсетях и выделяют трендовые товары. Для партнерской команды или команды по работе с инфлюенсерами эта страница отвечает на практические вопросы: кто этот автор, где еще он публикуется, что рекомендует в этом сезоне и насколько велик каждый список.

2026-11-17 SocQ добавил Amazon Storefront API, который возвращает одну витрину в виде одной структурированной записи. В этом руководстве разобраны запрос, поля, цена и то, как встроить эндпоинт в процесс исследования авторов.

Коротко: отправьте URL одной витрины в url на POST /v1/amazon/shop. Опрашивайте GET /v1/tasks/{task_id}, пока задача не завершится успешно, затем прочитайте одну строку из data.results.items с профилем автора, social_urls, lists, curations и trending_picks. Каждый запрос стоит 0.5 кредита ($0.0025).

Что возвращает эндпоинт

1 кредит SocQ = $0.005.

ЭндпоинтЧто возвращаетЦена
Amazon Storefront APIОдна строка на витрину: имя автора, описание, аватар, отметка топ-автора, связанные профили в соцсетях, идеи-списки с числом товаров, подборки с числом товаров и трендовые товары с ценами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 отправить один POST со сводкой задачи после ее завершения; сами записи читайте через GET /v1/tasks/{task_id}. Тайм-аут на стороне клиента не отменяет задачу, поэтому продолжайте с тем же ID задачи, а не платите за дубликат. 402 означает недостаточно кредитов; 429 означает, что ключ достиг лимита запросов или кредитов.

Запрос витрины

Единственный входной параметр — url, одна витрина в формате amazon.com/shop/<name>. Другие маркетплейсы 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"
  }'

Эндпоинт принимает один URL на запрос. Чтобы прочитать список витрин, отправьте по одной задаче на URL, сохраните каждый 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 и is_top_creator, который показывает, отмечает ли Amazon автора как топ-автора.
  • Охват на других платформах: social_urls — профили в соцсетях, привязанные к витрине.
  • Структура каталога: lists с title, url, image_url и items_count; curations с title, url, image_url и posts_count (число товаров в подборке).
  • Текущие акции: trending_picks с url, image_url, price в валюте маркетплейса и discount, если скидка показана.

Каждая строка также содержит collected_at — время, когда SocQ собрал данные. Цены меняются, поэтому сохраняйте эту метку времени вместе с каждой ценой. Полная таблица полей — в документации Amazon Storefront.

Когда использовать

Поиск партнеров для партнерской программы. is_top_creator, число списков и items_count в каждом из них быстро показывают, насколько активна витрина, еще до того, как кто-то из команды ее откроет.

Отслеживание рекомендаций автора. Перечитывайте витрину по расписанию и сравнивайте названия списков, их размеры и трендовые товары между запусками, чтобы видеть, что автор продвигает в этом сезоне.

Связь витрины с аккаунтами автора в соцсетях. social_urls дает профили TikTok, YouTube или Pinterest, которые привязал автор. Передайте их в API для авторов, чтобы найти публичные рабочие email, или в эндпоинты профилей платформ, чтобы получить число подписчиков.

Исследование товаров. Трендовые товары указывают на конкретные продукты. Для полных данных о товаре, отзывов или позиций в категориях используйте другие эндпоинты SocQ для Amazon, например Amazon Product Details API и Amazon Best Sellers API. Обзор того, как они соотносятся с собственными API Amazon, — в статье Альтернативы Amazon Product Advertising API.

Советы для продакшена

  1. Нормализуйте URL. Храните одну каноническую форму amazon.com/shop/<name> на автора, чтобы не платить дважды за одну и ту же витрину.
  2. Рассчитывайте на снимок первой страницы. Списки, подборки и трендовые товары — это те, что показаны на первой странице витрины. Считайте счетчики снимком на момент collected_at.
  3. Обрабатывайте ошибки отдельно. Запрос к несуществующей витрине завершается ошибкой с возвратом кредитов. Отмечайте такую витрину как удаленную, а не повторяйте запрос.
  4. Простое планирование бюджета. При цене 0.5 кредита за витрину 1,000 витрин стоят 500 кредитов, или $2.50.

FAQ

Что такое Amazon Storefront API?

Это эндпоинт SocQ, который читает одну витрину автора Amazon (amazon.com/shop/<name>) и возвращает профиль автора, связанные соцсети, идеи-списки, подборки и трендовые товары в виде одной структурированной записи.

Работает ли он за пределами amazon.com?

Да. В документации сказано, что другие маркетплейсы Amazon работают так же: отправьте в url адрес витрины на нужном маркетплейсе. Цены в trending_picks указаны в валюте этого маркетплейса.

Возвращает ли он все товары из всех списков?

Нет. Строка охватывает первую страницу витрины: название, URL, обложку и items_count каждого списка, число товаров в каждой подборке и текущие трендовые товары. Отдельные позиции каждого списка не раскрываются.

Списываются ли кредиты, если витрина не существует?

Нет. Запрос к несуществующей витрине завершается ошибкой с возвратом кредитов. Успешный запрос стоит 0.5 кредита ($0.0025).

Можно ли отправить несколько витрин в одном запросе?

Запрос принимает один url. Отправляйте по одной задаче на витрину и отслеживайте каждый task_id.

AMAZON API

Проверить сценарий на публичном URL Amazon

Отправляйте публичные входные данные и получайте нормализованные записи с отслеживаемым источником.

API для Amazon