amazon/
best-sellers

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

Amazon Best Sellers API

URL категории на входе
Записи товаров
0,15 кредита за результат
0,15 кредита за результат
Готово
Готово

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

README

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

Amazon Best Sellers

Страницы Amazon Best Sellers упорядочивают публично доступные товары в списках по категориям и, если эти данные показаны, содержат названия товаров, сведения о продавце, цены, рейтинги, число отзывов и продаж, медиафайлы, ссылки на источник и время наблюдения. SocQ превращает выбранные URL списков в нормализованные записи товаров для исследования категорий, сравнения ассортимента и воспроизводимых процессов работы с данными электронной коммерции.

Возможности Amazon Best Sellers API

  • Сбор по URL категорий в разных регионахОтправляйте один или несколько публичных URL Best Sellers или списков категорий на поддерживаемых маркетплейсах Amazon в рамках одной асинхронной задачи.
  • Нормализованная идентификация товараПолучайте стабильные записи товаров с доступными ID, названиями, описаниями, URL источника, метками платформы и ресурса и временем сбора.
  • Коммерческий контекст и репутацияДоступные данные о продавце, цены, рейтинги, число отзывов и продаж хранятся в отдельных полях, и разбирать разметку страницы не нужно.
  • Записи товаров с медиафайламиИспользуйте нормализованные медиаобъекты каждого товара для каталогов, очередей модерации, пайплайнов обогащения и последующего визуального анализа.

Параметры Amazon Best Sellers API

ПараметрыОбязательныйОписание
urlsОбязательныйОбязательный список ссылок Amazon на поддерживаемых хостах маркетплейсов или их поддоменах. Каждый путь должен содержать /zgbs/ или /gp/bestsellers/. Принимаются любые схемы с распознаваемым именем хоста и ссылки относительно протокола.
results_limitНеобязательныйНеобязательное целое число от 1 до 2 000. По умолчанию 100; ограничивает общее число уникальных записей товаров, сохраненных по всем отправленным URL.

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

Отправьте известные публичные URL Best Sellers, отслеживайте асинхронную задачу и постранично читайте нормализованные записи товаров.

  1. Подготовьте один или несколько публичных URL Amazon Best Sellers или списков категорий на поддерживаемом хосте маркетплейса.
  2. Отправьте urls и необязательный results_limit от 1 до 2 000 на /v1/amazon/best-sellers и сохраните возвращенный task_id.
  3. Опрашивайте /v1/tasks/{task_id}, пока задача не завершится успешно или не вернет ошибку.
  4. Читайте data.results.items и запрашивайте next_cursor, пока has_more остается true.
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-Books/zgbs/books"],"results_limit":3}'

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

Сценарии использования Amazon Best Sellers API

  • Снимки ассортимента категорий: Превращайте выбранные страницы Best Sellers в ограниченный перечень товаров со ссылками на источник и временем сбора для четко заданного исследовательского датасета.
  • Сравнение цен и репутации: Сравнивайте доступные цены, рейтинги, число отзывов и продаж у возвращенных товаров, не разбирая потом неоднородную разметку страниц.
  • Обогащение найденных товаров: Добавляйте названия, сведения о продавце, описания, медиафайлы и публичные URL товаров к шорт-листам, собранным со страниц категорий.

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

  • Используйте ссылки на поддерживаемых региональных хостах Amazon, пути которых содержат /zgbs/ или /gp/bestsellers/. Другие пути Amazon отклоняются еще до создания задачи.
  • Задавайте results_limit на всю задачу, а не на каждый отправленный URL, и рассчитывайте его на весь объединенный пакет.
  • Следуйте next_cursor, пока has_more не станет false: результаты задачи отдаются через отдельное представление с курсорной пагинацией.
  • Считайте ID, описания, данные о продавце, цены, рейтинги, счетчики, медиафайлы, URL и время публикации допускающими null и не заменяйте отсутствующие значения нулем или пустым объектом.
  • Сохраняйте collected_at с каждой записью и запускайте отдельные сборы, когда нужны сравнения во времени: эндпоинт не создает непрерывный поток данных.

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

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

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

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

Amazon Best Sellers API — FAQ

Amazon Best Sellers API — это программный интерфейс для сбора товаров с публичных URL Amazon Best Sellers или списков категорий в виде нормализованных записей товаров SocQ.

Массив urls принимает ссылки, у которых распознанное имя хоста — поддерживаемый маркетплейс Amazon или его поддомен, а путь содержит /zgbs/ или /gp/bestsellers/. Принимаются любые схемы с именем хоста и ссылки относительно протокола.

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

results_limit по умолчанию равен 100, принимает целые числа от 1 до 2 000 и ограничивает общее число уникальных записей, сохраненных для задачи по всем входным URL. Это не отдельный лимит для каждого URL.

Опрашивайте /v1/tasks/{task_id}, после успешного завершения читайте data.results.items и продолжайте запрашивать возвращенный next_cursor, пока has_more равно true. Лимит страницы результатов управляет пагинацией при чтении, а не объемом сбора.

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

Каждая успешно возвращенная стандартная запись товара стоит 0,15 кредита SocQ. Задача резервирует кредиты по results_limit (или по 100, если он не указан), затем рассчитывается по фактическому числу результатов и возвращает неиспользованный резерв; за пустой результат плата не взимается.