Ко всем API
Публичные торговые данные Amazon

Amazon Public Data API

Ищите публичные товары Amazon и собирайте нормализованные записи карточек товаров, бестселлеров, отзывов, профилей продавцов и витрин авторов с поддерживаемых маркетплейсов.

Доступные API Amazon

Используйте Product Search, Product Detail, Best Sellers, Reviews, Seller Info и Storefront для соответствующих сценариев работы с публичными данными Amazon.

Какие данные Amazon можно получить?

SocQ возвращает нормализованные записи товаров, отзывов, продавцов и витрин авторов по поддерживаемым публичным входным данным Amazon и оставляет поля пустыми (null), если источник не предоставляет пригодного значения.

Идентификаторы и контент товара

Получайте доступные ID товаров, названия, описания, публичные URL, метки платформы и ресурса, а также метки времени сбора.

Продавец и цена

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

Видимые сигналы репутации

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

Медиа товара

Получайте нормализованные медиаобъекты для каталогов товаров, очередей проверки и последующей обработки изображений.

Витрины авторов

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

SocQ vs самостоятельная обработка страниц

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

ВозможностьSocQСамостоятельная обработка
Входные данныеПоисковые запросы или поддерживаемые публичные URL AmazonURL страниц и собственная логика загрузки
Модель выполненияАсинхронная задача с опросом статусаОпределяется и обслуживается вашим приложением
Структура товараНормализованные записи товаровРазметка конкретной страницы и собственный парсинг
Доступ к сохраненным результатамЭлементы с курсорной пагинациейХранение и пагинация на стороне приложения

Как работает API Amazon

Эндпоинты Amazon используют асинхронную задачу, после которой результаты получают с курсорной пагинацией.

  1. 1. Отправьте входные данные эндпоинту

    Передайте поисковые запросы, URL товаров, URL категорий, URL продавцов или URL витрины, которые требует выбранный эндпоинт, и сохраните task_id.

  2. 2. Отслеживайте обработку

    Опрашивайте /v1/tasks/{task_id}, пока обработка не завершится успешно или задача не сообщит об ошибке.

  3. 3. Получите товары

    Читайте data.results.items и переходите по next_cursor, пока has_more равно true, чтобы получить все сохраненные записи.

Сбор товаров со страницы Best Sellers

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

curl -X POST "https://api.socq.ai/v1/amazon/best-sellers" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://www.amazon.com/Best-Sellers-Electronics/zgbs/electronics"],"results_limit":3}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is true

Типичные сценарии использования API Amazon

Исследование ассортимента категорий

Создавайте ограниченные снимки товаров, видимых на выбранных страницах Best Sellers, для заданного набора категорий.

Обогащение шорт-листа товаров

Добавляйте названия, описания, данные продавца, цены, медиа и публичные ссылки к товарам, найденным на выбранных страницах категорий.

Сравнение торговых сигналов

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

Поиск авторов для партнерской программы

Сравнивайте витрины авторов по отметке топ-автора, спискам идей, числу товаров и популярным товарам, чтобы отобрать партнеров.

Ограничения и политика публичных данных

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

  • Поддерживаются хосты amazon.com, amazon.co.uk, amazon.de, amazon.fr, amazon.es, amazon.it, amazon.ca, amazon.com.au, amazon.in и amazon.co.jp, включая их поддомены.
  • Используйте публичные страницы Best Sellers или списков категорий. Проверка хоста не гарантирует, что посторонняя страница Amazon содержит поддерживаемый список товаров.
  • results_limit по умолчанию равен 100, принимает значения от 1 до 2 000 и ограничивает общее число уникальных сохраненных результатов по всем URL в задаче.
  • Стабильный ответ не содержит поля с позицией в Best Sellers.
  • ID товаров, контент, продавец, цена, рейтинг, счетчики, медиа, URL и время публикации могут быть null, если пригодное публичное значение недоступно.

Частые вопросы об API Amazon

Что такое API Amazon?

API Amazon ищут товары и собирают нормализованные записи товаров, отзывов, продавцов и витрин авторов по поддерживаемым публичным входным данным Amazon.

Какие эндпоинты Amazon доступны?

Product Search, Product Detail, Best Sellers, Reviews, Seller Info и Storefront доступны через общий процесс асинхронных задач.

Можно ли собрать данные по нескольким URL категорий?

Да. Передайте несколько URL в одной задаче, но учтите, что results_limit — это один общий лимит на всю задачу, а не лимит на каждый URL.

Возвращает ли SocQ позицию товара в рейтинге?

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

Могут ли у товара Amazon отсутствовать поля?

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

Сколько стоит эндпоинт Best Sellers?

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

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

Apple App Store API

Собирайте публичные данные о приложениях Apple App Store, рейтинги категорий и отзывы по известным URL магазина в виде нормализованных записей приложений и отзывов.

SEO API

Запрашивайте органическую выдачу Google в реальном времени, сравнивайте спрос и сложность продвижения по ключевым словам, расширяйте исходные запросы, находите ключевые слова и страницы, которые обеспечивают сайту видимость в поиске, классифицируйте поисковый интент и собирайте результаты Google News, Google Images, Google Autocomplete, Bing и YouTube. Все эндпоинты используют один API-ключ SocQ, асинхронный процесс задач и нормализованный формат результатов.

Telegram API

Читайте открытые Telegram-каналы по ссылкам t.me: профили каналов с числом подписчиков, публикации с просмотрами и реакциями, отдельные публикации, комментарии из групп обсуждения, похожие каналы и поиск по всей истории.

Link in Bio API

Превращайте единственную ссылку из био автора в Instagram, TikTok или YouTube в структурированные данные: отображаемое имя, био, аватар, указанный контактный email, связанные профили в соцсетях и каждую кнопку страницы с заголовком и адресом.

Creator API

Начните с одного профиля в Instagram, TikTok, YouTube, X, Facebook или Threads и найдите публичные деловые email автора, его аккаунты в других сетях или оценку возраста и пола по фото профиля.

Google Hotels API

Ищите отели по направлению, открывайте полную карточку любого отеля в Google Hotels и получайте его календарь цен за ночь — всё связано одним ID отеля.