Что это
Yotpo Reviews API помогает работать с пользовательскими отзывами: получать тексты и оценки, строить отчеты и связывать обратную связь с товаром. Для своей интеграции важно выбрать нужное семейство методов, а не просто любой API с названием Yotpo.
UGC и storefront относятся к отзывам и их показу. Core API работает с основными данными магазина, Loyalty - с отдельным продуктом лояльности. Их адреса, авторизацию и условия нельзя смешивать.
Само чтение отзывов не является ИИ-анализом. Поиск повторяющихся жалоб или черновик ответа выполняет отдельная программа либо модель. Для старта получите уже опубликованные отзывы одного своего товара и проверьте, что они относятся к нему.
Ключевые параметры
- Категория: Операционные задачи
- Сложность: Для разработчика
- Запуск: Около 30 минут
- Open-source: Нет
- Данные: Не известно
- Чувствительные данные: Только с настройками
Сильные стороны
- Можно получать отзывы вместе с рейтингами и сведениями о товаре.
- Пагинация позволяет читать большой набор по частям.
- ID товара помогает сопоставить обратную связь со своим каталогом.
- Для интеграции доступны отдельные семейства методов под разные задачи.
Ограничения
- Доступ к закрытым методам и операциям зависит от продукта, тарифа и прав магазина.
- Storefront-метод выбранного товара получает данные с задержкой до трех часов.
- Store ID и ID товара на вашем сайте нельзя заменять названием товара или случайным SKU.
- ИИ-классификация жалоб, обезличивание и согласование ответов не входят в обычное чтение API.
Как использовать
1. Подготовка. Получите разрешение администратора своего Yotpo-магазина. Выберите товар с уже опубликованным отзывом и запишите его внешний product_id, Store ID и ожидаемую оценку. Уточните доступ к нужному методу по своему тарифу.
2. Настройка. Для актуальной token-авторизации получите токен через POST https://api.yotpo.com/core/v3/stores/<store_id>/access_tokens с JSON {"secret":"<API secret>"}. Сохраните полученный токен на сервере. В справочнике выбранного storefront-метода указан заголовок X-Yotpo-Token; не подставляйте вместо него произвольный Bearer или credentials Loyalty.
3. Первый результат. Выполните GET https://api-cdn.yotpo.com/v1/widget/<store_id>/products/<product_id>/reviews.json?per_page=10&page=1 с заголовком X-Yotpo-Token. Соберите только ID отзыва, оценку и текст; не выгружайте сведения о пользователях в учебный отчет.
4. Проверка. Сопоставьте товар и несколько отзывов с витриной. Учтите задержку этого метода до трех часов и проверьте следующие страницы, прежде чем считать данные полными. При 401 проверьте токен, при пустой выдаче - магазин, внешний ID товара и наличие опубликованных отзывов. Не включайте создание отзывов и публикацию ответов в первый тест.
Примеры сценариев
- Сверить рейтинг конкретного товара с витриной.
- Собрать обезличенные жалобы для проверки человеком.
- Отделить задержку обновления от ошибки подключения.
Доступ и оплата
- Модель оплаты: Не уточнено
- Работа в РФ: Нужно проверять
- VPN: Не известно
- Русский интерфейс: Не известно
- Русский язык: Не известно
Наличие виджета или бесплатного продукта Yotpo не гарантирует доступ к каждому API-методу. Часть возможностей требует подходящего платного плана. Точную стоимость, доступ из России и способ оплаты уточняйте для своего магазина; эти условия здесь не подтверждены.
Когда не подходит
- Генерировать фиктивные отзывы от покупателей
- Считать первую страницу полным архивом
- Публиковать ответ или менять отзыв без проверки
Альтернативы
Trustpilot Business API работает с отзывами Trustpilot, Google Business Profile API - с отзывами о доступных профилях бизнеса. Ozon Seller API относится к своему кабинету маркетплейса и доступным в нем методам. Эти системы не предоставляют ваши отзывы Yotpo без подключения самого Yotpo.
