amazon/
reviews

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

Amazon Reviews API

Несколько URL товаров
Тексты отзывов и рейтинги
Автор и товар
Нормализованные записи отзывов
0,15 кредита за результат
Готово
Готово

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

README

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

Amazon Reviews

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

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

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

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

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

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

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

  1. Подготовьте один или несколько поддерживаемых URL товаров Amazon и выберите results_limit от 1 до 2 000.
  2. Отправьте запрос методом POST на /v1/amazon/reviews и сохраните возвращенный task_id.
  3. Опрашивайте GET /v1/tasks/{task_id}, пока задача не завершится успешно или не вернет ошибку.
  4. Читайте data.results.items и запрашивайте возвращенный next_cursor, пока has_more остается true.
curl -X POST "https://api.socq.ai/v1/amazon/reviews" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://www.amazon.com/dp/B0CHHSFMRL"],"results_limit":3}'

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

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

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

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

  • Используйте ссылки на товары, у которых распознанное имя хоста относится к поддерживаемому маркетплейсу Amazon; короткие ссылки на посторонних хостах и неподдерживаемые региональные хосты не проходят проверку.
  • Задавайте results_limit как общее число отзывов, которое нужно сохранить по всем отправленным URL, а затем следуйте next_cursor, пока has_more не станет false, чтобы прочитать все сохраненные страницы.
  • Используйте id отзыва как ключ записи, если он есть, и сохраняйте subject_id или subject_url, когда группируете отзывы по товарам.
  • Считайте отсутствующие текст, поля автора, рейтинги, метки времени, ссылки на товары и медиафайлы неизвестными значениями и не придумывайте замену.

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

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

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

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

Amazon Reviews API — FAQ

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

Передайте непустой массив urls, в котором распознанные имена хостов — amazon.com, amazon.co.uk, amazon.de, amazon.fr, amazon.es, amazon.it, amazon.ca, amazon.com.au, amazon.in, amazon.co.jp или их поддомены. Принимаются любые схемы с именем хоста и ссылки относительно протокола.

results_limit — это максимальное число нормализованных отзывов, сохраняемых для всей задачи, а не гарантированное количество для каждого URL. Задача может завершиться с меньшим числом записей, если публичных отзывов вернулось меньше или были удалены дубликаты.

После успешного завершения задачи читайте data.results.items и передавайте next_cursor эндпоинту задачи, пока has_more равно true. Эндпоинт результатов задачи принимает лимит страницы от 1 до 500.

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