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