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

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

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

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

Параметры

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

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

Ответ

idчисло

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

link_idчисло

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

source_idчисло

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

source_slugстрокаможет быть null

Слаг площадки (2gis, google, yandex_maps). Отвечать можно, если совпадает с provider отзыва.

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

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

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

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

review_dateдата и времяможет быть null

Когда отзыв опубликован: в UTC, если площадка позволяет пересчитать время, иначе – как показывает площадка.

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

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

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

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

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

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

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

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

reply_dateдата и времяможет быть null

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

providerстрокаможет быть null

Площадка, на которой отзыв написан изначально (слаг в нижнем регистре: 2gis, google, tbank, booking, tripadvisor, …). У нативного отзыва совпадает с source_slug – только на такой отзыв можно опубликовать ответ.

is_replyableда/нетможет быть null

Можно ли ответить на отзыв через PUT /v3/reviews/{review_id}/reply. Приходит только на площадках, где Rewio публикует ответы (can_publish_reply в GET /v3/sources); на остальных ключа нет. true – ответы на ссылке подключены, и отзыв родной для площадки (provider пуст или равен source_slug). false – ответ вернёт ошибку: отзыв другой площадки (2ГИС показывает отзывы Netmonet, Booking, Т-Банка – 409 reply_not_replyable) или ответы на ссылке не подключены. Тариф флаг не учитывает.

our_replyобъектможет быть null

Ваш ответ, отправленный через Rewio, и его состояние – то же, что в GET /v3/reviews/{review_id}/reply. null – ответа через Rewio нет или тариф без ответов. Ответ, поставленный не через Rewio, – в reply_text.

our_reply.statusстрокаpending / published / failed / deletedможет быть null

Что с вашим ответом на карточке: null – отправлен, площадке ещё не передан; pending – площадка приняла, на карточке ещё не видели (проверяем через 15 с, 30 с, 1 мин … 4 ч); published – ваш текст стоит на карточке; deleted – вашего ответа на карточке нет: вы его удалили или он пропал (причина – в error); failed – не опубликован (почему – в error).

our_reply.textстрока

Текст, который должен стоять на площадке. Пусто – ответ снимается.

our_reply.submitted_atдата и времяможет быть null

Когда вы отправили этот текст (UTC).

our_reply.published_atдата и времяможет быть null

Когда мы увидели ваш текст на карточке (UTC).

our_reply.updated_atдата и время

Когда ответ меняли в последний раз (UTC).

our_reply.errorобъектможет быть null

Почему ответ не опубликован или пропал с карточки.

our_reply.error.codeстрока

Машинный код ошибки публикации.

our_reply.error.messageстрока

Пояснение для человека.

is_skippedда/нет

Вы отметили отзыв «Пропустить» (PUT /v3/reviews/{review_id}/skip). На тарифе без ответов всегда false.

complaintобъектможет быть null

Последняя жалоба на отзыв. null – жалоб нет или тариф без жалоб.

complaint.statusстрокаpending / accepted / rejected / failedможет быть null

null – отправляется на площадку; pending – на рассмотрении; accepted – отзыв удалён; rejected – отзыв остался. Подробно – GET /v3/reviews/{review_id}/complaints.

complaint.filed_atдата и времяможет быть null

Когда жалоба подана (UTC).

complaint.is_oursда/нет

true – подана через Rewio; false – найдена на площадке.

Ещё 20 полей – нужны реже

has_imagesда/нет

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

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

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

images[].template_urlстрока

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

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

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

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

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

has_videosда/нет

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

is_deletedда/нет

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

deleted_atдата и времяможет быть null

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

is_hiddenда/нет

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

is_pinnedда/нет

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

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

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

prosстрокаможет быть null

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

consстрокаможет быть null

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

curl -X GET "https://api.rewio.tech/v3/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": [],  "source_slug": "yandex_maps",  "is_replyable": true,  "our_reply": null,  "is_skipped": false,  "complaint": null}

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

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

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

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

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