Документация API v2. Версия заморожена и продолжает работать; актуальная — на главной. Что изменилось: переход с v2 на v3.
Отзывы

Получить отзыв по id

Доступ для AI:

Один отзыв по его идентификатору. Ответ – ровно та же модель, что приходит элементом data в ленте отзывов.

Метод нужен там, где идентификатор уже на руках, а объекта под ним нет: вебхук приносит id отзыва, а не объект; после публикации ответа проверить reply_text больше нечем.

Достаточно ключа со скоупом read_only.

GET
/v2/reviews/{review_id}

Параметры

review_idчислообязательный

Идентификатор отзыва в Rewio – тот же id, что в ленте отзывов и в событии вебхука.

Ответ

idчисло

Идентификатор отзыва в Rewio.

link_idчисло

Ссылка, с которой собран отзыв.

source_idчисло

Площадка, с которой собран отзыв.

authorстрокаможет быть пустым

Имя автора так, как его показывает площадка. Фамилии маскируются.

textстрокаможет быть пустым

Текст отзыва.

review_dateдата и времяможет быть пустым

Когда отзыв опубликован, по времени площадки.

rating_originalстрокаможет быть пустым

Оценка в шкале самой площадки, как есть.

ratingчисломожет быть пустым

Та же оценка, приведённая к шкале 1–5.

review_urlстрокаможет быть пустым

Прямая ссылка на отзыв на площадке.

reply_textстрокаможет быть пустым

Ответ организации на отзыв.

reply_dateдата и времяможет быть пустым

Когда организация ответила.

Ещё 20 полей – реже нужны
has_imagesда/нет

Есть ли у отзыва изображения.

imagesсписок объектов

Изображения отзыва.

images[].template_urlстрока

Адрес с плейсхолдером {size}, в таком виде его отдаёт площадка.

images[].previewстрокаможет быть пустым

Уменьшенная версия для списков и сеток.

images[].imageстрокаможет быть пустым

Полноразмерная версия для просмотра.

has_videosда/нет

Есть ли у отзыва видео.

videosсписок объектов

Видео отзыва.

videos[].kindстрокаembed / file / hls

embed – плеер площадки, file – прямой файл, hls – поток.

videos[].video_urlстрокаможет быть пустым

Адрес видео или плеера, смотря какой kind.

videos[].thumbnailстрокаможет быть пустым

Кадр-заставка.

videos[].widthчисломожет быть пустым

Ширина в пикселях, если площадка её сообщает.

videos[].heightчисломожет быть пустым

Высота в пикселях, если площадка её сообщает.

videos[].duration_msчисломожет быть пустым

Длительность в миллисекундах, если площадка её сообщает.

is_deletedда/нет

Отзыв пропал с площадки.

deleted_atдата и времяможет быть пустым

Когда мы заметили пропажу.

is_hiddenда/нет

Отзыв скрыт в объекте.

is_pinnedда/нет

Отзыв закреплён в объекте.

pin_positionчисломожет быть пустым

Место отзыва среди закреплённых, считая с нуля.

positiveстрокаможет быть пустым

Блок «достоинства».

negativeстрокаможет быть пустым

Блок «недостатки».

curl -X GET "https://example.com/v2/reviews/0"
{  "id": 918342,  "link_id": 57,  "source_id": 1,  "author": "Марина К.",  "text": "Номер чистый, завтрак хороший. Заселили раньше времени, спасибо.",  "review_date": "2026-08-14T09:41:00",  "rating_original": 9,  "rating": 4.5,  "review_url": "https://yandex.ru/maps/org/12345/reviews/?reviews%5BpublicId%5D=abc123",  "reply_text": "Спасибо за отзыв! Ждём вас снова.",  "reply_date": "2026-08-15T07:12:00",  "has_images": false,  "images": [],  "has_videos": false,  "videos": []}

Чего в ответе не будет

Отзыв чужого аккаунта и отзыв, которого не существует, отвечают одинаково – 404 с кодом not_found. Ответы намеренно неразличимы: иначе перебор идентификаторов рассказывал бы о чужих данных.

Видимость та же, что у ленты по умолчанию:

  • отзыв, пропавший с площадки, по идентификатору не отдаётся;
  • отзыв, скрытый в объекте, тоже не отдаётся;
  • на пробном доступе действует тот же потолок видимости, что и в ленте, – отзыв старше этого потолка отвечает 404.

Коды ошибок общие для всего API и описаны на странице Ошибки.