Задать порядок закреплённых

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

Это замена, а не добавление – отзывы, которых нет в списке, открепляются, а пустой список снимает закрепление со всех. Первый в списке получает pin_position: 0, следующий – 1, и так далее.

Не больше 30 отзывов, без повторов: и то и другое – 400.

Так удобнее переставлять: вы присылаете желаемый итог, а не двигаете отзывы по одному. Два одновременных запроса к одному объекту выполняются по очереди, порядок не перемешается.

Параметры

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

Объект, в котором задаётся порядок.

Тело запроса

ordered_review_idsсписок чиселобязательный

Закреплённые отзывы целиком, в нужном порядке. Первый в списке окажется первым в выдаче.

Ответ

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числоможет быть пустым

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

Ещё 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_pinnedда/нет

Всегда true.

curl -X PUT "https://example.com/v3/objects/0/pinned-reviews" \  -H "Content-Type: application/json" \  -d '{    "ordered_review_ids": [      142391,      143046    ]  }'

{  "data": [    {      "id": 142391,      "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    },    {      "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 и описаны на странице Ошибки.