amazon/
shop

Читает витрину автора на Amazon по ссылке amazon.com/shop и возвращает профиль, связанные аккаунты в соцсетях, списки идей с числом товаров, подборки и популярные товары с ценами.

Amazon Storefront API

Ссылка на витрину на входе
Списки идей
Подборки
Популярные товары
0,5 кредита за запрос
Готово
Готово

Введите параметры и отправьте запрос. Здесь появятся статус задачи и нормализованные результаты.

README

Автор: SocQ · Обновлено

Amazon Storefront

Amazon storefront — это витрина, которую участник программы Amazon Influencer ведет под собственным названием магазина: товары в ней сгруппированы в списки идей и подборки, а рядом размещены описание, фото профиля, ссылки на соцсети и ряд популярных товаров. По витрине видно, кто автор, где еще он публикуется, как устроены его рекомендации и какие товары он продвигает прямо сейчас и по какой цене.

Возможности Amazon Storefront API

  • Профиль и отметка топ-автораname, text и avatar_url дают отображаемое имя, описание витрины и фото профиля, а is_top_creator показывает, отмечает ли Amazon автора как топового.
  • Связанные аккаунты в соцсетяхsocial_urls содержит ссылки на профили в TikTok, YouTube, Pinterest и других сетях, размещенные в шапке витрины.
  • Списки идей с числом товаровlists возвращает каждый список идей с первой страницы витрины с названием, ссылкой, обложкой и items_count — количеством товаров в нем.
  • Подборкиcurations возвращает подборки автора с названием, ссылкой, обложкой и posts_count — числом товаров, собранных в каждой.
  • Популярные товары с ценамиtrending_picks возвращает товары, которые витрина сейчас выделяет, и для каждого дает ссылку в витрине, изображение, текущую цену в валюте площадки и показанную скидку.

Параметры Amazon Storefront API

ПараметрыОбязательныйОписание
urlОбязательныйСсылка на витрину автора на Amazon в формате https://www.amazon.com/shop/<name>; ссылки на витрины других площадок Amazon работают так же.

Как использовать Amazon Storefront API

Отправьте ссылку на витрину и прочитайте ее как одну строку результата.

  1. Отправьте POST-запрос на /v1/amazon/shop, передав в поле url ссылку на витрину, например https://www.amazon.com/shop/sydneydelrey.
  2. Опрашивайте GET /v1/tasks/{task_id}, пока status не станет succeeded.
  3. Прочитайте витрину из results.items; has_more и results.next_cursor работают по обычным правилам пагинации и для этой единственной строки остаются пустыми.
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, чтобы видеть, какие сезонные списки растут и какие товары выходят на первый план.
  • Связь витрины с соцсетями: Через social_urls привязывайте каждую витрину к профилям автора в TikTok, YouTube или Pinterest, чтобы продажи и охват в соцсетях хранились в одной записи.

Практические советы по Amazon Storefront API

  • Сохраняйте домен площадки вместе с каждым результатом: trending_picks.price указан в валюте этой площадки.
  • Используйте id — название витрины из ссылки — как ключ, чтобы повторные чтения одного автора совпадали.
  • Чтобы получить товары по отдельности, откройте список или подборку по их url; items_count и posts_count заранее покажут их размер.

Помимо Amazon Storefront API, используйте эти API, когда нужен другой тип публичных данных Amazon.

  • Amazon Best Sellers API — Собирайте товары по публичным URL категорий Amazon Best Sellers: нормализованные поля продавца, цены, репутации, числа продаж, медиа, источника и метки времени.
  • Amazon Product Details API — Собирайте данные о товарах по известным URL Amazon: название, описание, продавец, цена, рейтинг, число отзывов, число продаж и медиа.
  • Amazon Product Search API — Ищите товары в поддерживаемой витрине Amazon по фразе и получайте нормализованные поля товара, продавца, цены, рейтинга, отзывов, числа продаж, медиа и источника, если они доступны.
  • Amazon Reviews API — Собирайте публичные отзывы о товарах по поддерживаемым URL Amazon: текст, оценки, данные автора, ссылки на товар, метки времени и медиа.
  • Amazon Seller Info API — Собирайте по известным URL продавцов публичные данные профиля продавца Amazon: название, описание, сайт, рейтинг, отзывы покупателей, местоположение, источник и время сбора.

Другие платформы

Объединяйте данные Amazon с публичными данными других поддерживаемых соцсетей.

Amazon Storefront API — FAQ

Amazon Storefront API — это программный интерфейс, который читает витрину автора на Amazon по ссылке на эту витрину. Он возвращает профиль автора, связанные аккаунты в соцсетях, списки идей, подборки и популярные товары с ценами.

В каждом запросе передается одна ссылка на витрину в формате amazon.com/shop/имя. Витрины на других площадках Amazon, например amazon.de/shop/имя, читаются так же.

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

Для каждого популярного товара есть ссылка в витрине, изображение, текущая цена в валюте площадки и метка скидки, если витрина ее показывает.

Каждый запрос читает одну витрину и стоит 0,5 кредита; если витрина не существует, задача завершается ошибкой и полностью возвращается на баланс.