Авторы из программы 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.
Советы для продакшена
- Нормализуйте URL. Храните одну каноническую форму
amazon.com/shop/<name>на автора, чтобы не платить дважды за одну и ту же витрину. - Рассчитывайте на снимок первой страницы. Списки, подборки и трендовые товары — это те, что показаны на первой странице витрины. Считайте счетчики снимком на момент
collected_at. - Обрабатывайте ошибки отдельно. Запрос к несуществующей витрине завершается ошибкой с возвратом кредитов. Отмечайте такую витрину как удаленную, а не повторяйте запрос.
- Простое планирование бюджета. При цене 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