Закреплённые отзывы

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

Без sort_by порядок в ответе – порядок закрепления. Передали sort_by – закреплённые пересортируются по дате, оценке или дате ответа, а pin_position останется прежним.

Закрепление работает внутри объекта: в папочной ленте (folder_id) оно не применяется, и такие отзывы приходят обычными строками.

Параметры

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

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

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

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

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

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

sort_byстрокаreview_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 параметра – нужны реже

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

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

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

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

Ответ

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

Закреплённые отзывы в порядке закрепления.

data[].idчисло

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

data[].link_idчисло

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

data[].source_idчисло

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Площадка, на которой отзыв написан изначально (слаг в нижнем регистре). У нативного отзыва совпадает с source_slug.

data[].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) или ответы на ссылке не подключены. Тариф флаг не учитывает.

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

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

data[].our_replyобъектможет быть null

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

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

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

data[].our_reply.textстрока

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

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

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

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

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

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

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

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

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

data[].our_reply.error.codeстрока

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

data[].our_reply.error.messageстрока

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

data[].is_skippedда/нет

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

data[].complaintобъектможет быть null

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

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

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

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

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

data[].complaint.is_oursда/нет

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

totalчисло

Общее число элементов, подходящих под фильтры (без учёта limit/offset).

limitчисло

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

offsetчисло

Смещение от начала выборки, применённое к запросу.

has_nextда/нет

Есть ли ещё элементы за пределами текущей страницы.

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

data[].has_imagesда/нет

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

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

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

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

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

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

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

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

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

data[].has_videosда/нет

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

data[].is_deletedда/нет

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

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

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

data[].is_pinnedда/нет

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

curl -X GET "https://api.rewio.tech/v3/objects/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": 1    }  ]}

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