Закреплённые отзывы
Отзывы, поднятые в начало выдачи, в том порядке, в котором их закрепили. Этим порядком и собирают верх страницы: закреплённые берут отсюда, остальное – общей лентой.
Без sort_by порядок в ответе – порядок закрепления. Передали sort_by – закреплённые
пересортируются по дате, оценке или дате ответа, а pin_position останется прежним.
Закрепление работает внутри объекта: в папочной ленте (folder_id) оно не применяется, и такие отзывы
приходят обычными строками.
Параметры
group_idчислообязательныйОбъект, закреплённые отзывы которой нужны.
link_idsсписок чиселпо умолчанию пустоТолько по этим ссылкам внутри объекта. Пусто – по всем.
source_idsсписок чиселпо умолчанию пустоТолько с этих площадок. Пусто – со всех.
sort_byстрокаdate / rating / reply_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дата и времяможет быть пустымКогда организация ответила.
data[].pin_positionчисломожет быть пустымМесто отзыва среди закреплённых, считая с нуля.
totalчислоОбщее число элементов, подходящих под фильтры (без учёта limit/offset).
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 / hlsembed – плеер площадки, 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_pinnedда/нетВсегда true: здесь только закреплённые.
curl -X GET "https://example.com/v2/groups/0/pinned-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_pinned": true, "pin_position": 0 } ]}Коды ошибок общие для всего API и описаны на странице Ошибки.