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, отслеживайте асинхронную задачу и постранично читайте нормализованные записи товаров.
- Подготовьте один или несколько публичных URL Amazon Best Sellers или списков категорий на поддерживаемом хосте маркетплейса.
- Отправьте urls и необязательный results_limit от 1 до 2 000 на /v1/amazon/best-sellers и сохраните возвращенный task_id.
- Опрашивайте /v1/tasks/{task_id}, пока задача не завершится успешно или не вернет ошибку.
- Читайте 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 с каждой записью и запускайте отдельные сборы, когда нужны сравнения во времени: эндпоинт не создает непрерывный поток данных.
Связанные API
Помимо 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 по ссылке на нее: профиль, связанные аккаунты в соцсетях, списки идей с числом товаров, подборки и популярные товары с ценами.