Обзор

Rewio API собирает отзывы о ваших объектах (отелях, клиниках, ресторанах) с 20+ площадок — Яндекс.Карты, 2ГИС, Google, Otzovik, TripAdvisor, Островок и других — нормализует их к единому формату и отдаёт через один REST API. Вам не нужно писать и поддерживать парсер под каждую площадку: вы работаете с одним предсказуемым JSON-интерфейсом.

Для кого это

• Разработчики и студии, которые встраивают отзывы в сайт клиента, CRM, дашборд или виджет.
• Travel-tech и медтех-платформы, которым нужен поток отзывов по множеству объектов без своей инфраструктуры скрейпинга.
• Продукты работы с репутацией (SERM) — мониторинг новых и негативных отзывов, ответы, аналитика.

Модель данных в трёх абзацах

Всё вращается вокруг трёх сущностей. Группа (group) — это ваш объект учёта, обычно один отель или одна клиника. К группе вы привязываете ссылки (link) — по одной на каждую площадку: страница объекта в Яндекс.Картах, в 2ГИС, на Otzovik и т. д. Rewio периодически обходит эти ссылки и складывает найденные отзывы (review) в группу.

Каждый отзыв нормализован: оценка приведена к шкале 1–5 (исходная сохранена в rating_original), проставлены дата публикации (review_date), автор, текст, ответ площадки (reply_text), фото и видео. Отзывы дедуплицируются — один и тот же отзыв с одной площадки не задваивается, даже если встретился при нескольких обходах.

Вы читаете отзывы через GET /v2/reviews?group_id=... с фильтрами, сортировкой и пагинацией; получаете агрегированную аналитику через GET /v2/analytics; а чтобы не опрашивать API вхолостую — подписываетесь на вебхуки и получаете пуш при появлении новых отзывов.

Соглашения

• Базовый URL: https://api.rewio.ru. Актуальная версия — /v2 (канон).
• Версия v1 заморожена и помечена deprecated: см. Версионирование.
• Аутентификация: заголовок X-API-Key. См. Аутентификация.
• Даты: всё в UTC (ISO 8601), кроме review_date — это местное время площадки, как его показывает сама площадка, без пересчёта в UTC.
• Оценки: нормализованы к шкале 1–5 (дробные допустимы, напр. 4.5).
• Форма списков: пагинированные ответы — {data, total, limit, offset, has_next}; ответы «вернуть всё» — {data}. Ключ элементов всегда data.
• Ошибки: {"detail": "...", "code": "machine_readable_code"}. См. Ошибки.
• Лимит запросов: 300 запросов в минуту на ключ.