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

Скрытые отзывы

Доступ для AI:

Отзывы, спрятанные в этом объекте – те, что не попадают в обычную ленту. Экран модерации строят на этой ручке: показать скрытое и дать вернуть обратно.

Скрытие действует внутри объекта: тот же отзыв в другом объекте останется видимым.

Фильтры, сортировка и постраничная выдача устроены как в общей ленте, но список параметров короче – он весь ниже. В частности, разбора текста на достоинства и недостатки здесь нет: separate_pos_neg эта ручка не принимает.

GET
/v2/groups/{group_id}/hidden-reviews

Параметры

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

Объект, скрытые отзывы которой нужны.

link_idsсписок чиселпо умолчанию пусто

Только по этим ссылкам внутри объекта. Пусто – по всем.

source_idsсписок чиселпо умолчанию пусто

Только с этих площадок. Пусто – со всех.

sort_byстрокаdate / rating / reply_dateпо умолчанию «date»

По дате публикации, по оценке или по дате ответа организации (reply_date).

sort_orderстрокаdesc / ascпо умолчанию «desc»

desc – сначала новые (или высокие оценки), asc – наоборот.

min_ratingчисло1–5

Оценка не ниже указанной, по шкале 1–5.

max_ratingчисло1–5

Оценка не выше указанной.

published_fromдата

Отзывы, опубликованные не раньше этой даты.

published_toдата

Отзывы, опубликованные не позже этой даты. Названный день входит в период целиком.

has_imagesда/нет

true – только с изображениями, false – только без.

has_textда/нет

true – только с текстом, false – только оценки без текста.

has_replyда/нет

true – только с ответом организации, false – только без ответа.

searchстрока

Поиск подстроки в тексте отзыва, без учёта регистра.

limitчисло1–1000по умолчанию 100

Сколько отзывов вернуть за один запрос.

offsetчислоне меньше 0по умолчанию 0

Сколько отзывов пропустить с начала выборки.

Ещё 2 параметра – реже нужны
include_deletedда/нетпо умолчанию нет

Добавить к выдаче отзывы, пропавшие с площадки.

only_deletedда/нетпо умолчанию нет

Только пропавшие с площадки отзывы.

Ответ

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

Скрытые отзывы текущей страницы.

data[].idчисло

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

data[].link_idчисло

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

data[].source_idчисло

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

totalчисло

Сколько отзывов скрыто в этом объекте.

limitчисло

Размер страницы, применённый к запросу.

offsetчисло

Смещение, применённое к запросу.

has_nextда/нет

Есть ли ещё отзывы за текущей страницей.

Ещё 16 полей – реже нужны
data[].has_imagesда/нет

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

data[].imagesсписок объектов

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

data[].images[].template_urlстрока

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

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

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

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

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

data[].has_videosда/нет

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

data[].videosсписок объектов

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

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

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

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

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

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

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

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

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

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

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

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

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

data[].is_deletedда/нет

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

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

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

data[].is_hiddenда/нет

Всегда true: здесь только скрытые.

curl -X GET "https://example.com/v2/groups/0/hidden-reviews"
{  "data": [    {      "id": 143046,      "link_id": 177,      "source_id": 1,      "author": "Сергей",      "text": "Замечательно. Приеду ещё. ",      "review_date": "2026-07-21T18:07:03",      "rating_original": "5",      "rating": 5,      "review_url": "https://yandex.ru/maps/org/1020542995/reviews?reviews[publicId]=u182gzp1r9rg4urew906ky9dd0",      "reply_text": "Уважаемый Гость,\nБлагодарим Вас за визит в гостиницу «Националь» и высокую оценку нашего обслуживания. Ждем Вас снова!\nС наилучшими пожеланиями,\t\nЕлена Позолотина\nДиректор по операционной деятельности.\n",      "reply_date": "2026-07-23T13:27:07",      "has_images": true,      "images": [        {          "template_url": "https://avatars.mds.yandex.net/get-altay/17743308/2a0000019f85dc34d7ee3b24b4b9ec82bdbd/{size}",          "preview": "https://avatars.mds.yandex.net/get-altay/17743308/2a0000019f85dc34d7ee3b24b4b9ec82bdbd/M",          "image": "https://avatars.mds.yandex.net/get-altay/17743308/2a0000019f85dc34d7ee3b24b4b9ec82bdbd/XXXL"        },        {          "template_url": "https://avatars.mds.yandex.net/get-altay/18473509/2a0000019f85dc42d3b7bbf4e10e375c612e/{size}",          "preview": "https://avatars.mds.yandex.net/get-altay/18473509/2a0000019f85dc42d3b7bbf4e10e375c612e/M",          "image": "https://avatars.mds.yandex.net/get-altay/18473509/2a0000019f85dc42d3b7bbf4e10e375c612e/XXXL"        },        {          "template_url": "https://avatars.mds.yandex.net/get-altay/20191917/2a0000019f85dc255b9c227cfbc55fc57724/{size}",          "preview": "https://avatars.mds.yandex.net/get-altay/20191917/2a0000019f85dc255b9c227cfbc55fc57724/M",          "image": "https://avatars.mds.yandex.net/get-altay/20191917/2a0000019f85dc255b9c227cfbc55fc57724/XXXL"        }      ],      "has_videos": false,      "videos": [],      "is_hidden": true    }  ],  "total": 1,  "limit": 100,  "offset": 0,  "has_next": false}

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