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

Отзывы одного объекта или всей папки – с фильтрами, сортировкой и постраничной выдачей.

Объект или папку указывают ровно одну: либо group_id, либо folder_id.

Параметры

group_id · folder_idчисло

Объект или папка целиком. В запросе должно быть ровно одно из двух.

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

Ограничить выдачу конкретными ссылками объекта или площадками. Пусто – без ограничения.

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

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

min_rating · max_ratingчисло0–51–5

Границы оценки по шкале 1–5, включительно.

published_from · published_toдата

Границы даты публикации, включительно. Названный в верхней границе день входит в период целиком.

has_images · has_videosда/нет

Наличие фотографий и видео. true – только с ними, false – только без.

has_text · has_replyда/нет

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

searchстрока

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

limit · offsetчисло1–1000по умолчанию 100не меньше 0по умолчанию 0

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

Ещё 3 параметра – реже нужны

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

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

show_hidden · show_pinnedда/нетпо умолчанию нет

Показывать отзывы, скрытые или закреплённые в этом объекте. По умолчанию лента не отдаёт ни тех, ни других – как это устроено.

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

Разбирать слитый текст на «достоинства» и «недостатки»: часть площадок отдаёт их одной строкой. Разобранные блоки убираются из text – подробнее.

Ответ

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.

limitчисло

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

offsetчисло

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

has_nextда/нет

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

accessобъектможет быть пустым

Ограничение выдачи. Присутствует только когда пробному доступу показали не всё — у обычного клиента ключа нет.

access.reasonстрока

Почему выдача ограничена. trial — пробный доступ.

access.limit_per_linkчисло

Сколько последних отзывов показывается по КАЖДОЙ ссылке (площадке объекта). Ограничение на ссылку, не на аккаунт и не на группу.

access.hidden_totalчисло

Сколько отзывов уже собрано сверх показанных. Считается по всему архиву и НЕ зависит от фильтров запроса.

access.messageстрока

Готовая формулировка на английском. Для интерфейса на другом языке стройте текст по числам выше.

collectingобъектможет быть пустым

Первого сбора по части площадок объекта ещё не было. Приходит только пока это так.

collecting.links_totalчисло

Сколько площадок участвует в выдаче.

collecting.collecting_totalчисло

По скольким из них сбор идёт прямо сейчас.

collecting.failed_totalчисло

По скольким из них первый сбор не удался.

collecting.messageстрока

Готовая формулировка на английском.

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

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да/нет

Отзыв скрыт в этом объекте. Приходит только при show_hidden=true.

data[].is_pinnedда/нет

Отзыв закреплён в этом объекте. Приходит только при show_pinned=true.

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

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

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

Блок «достоинства». Приходит только при separate_pos_neg=true.

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

Блок «недостатки». Приходит только при separate_pos_neg=true.

curl -X GET "https://example.com/v2/reviews?group_id=20"

{  "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": []    }  ],  "total": 397,  "limit": 1,  "offset": 0,  "has_next": true}

Пустая выдача сразу после создания объекта

Сбор по новой площадке занимает от нескольких секунд до нескольких минут, и всё это время отзывов по ней ещё нет. Чтобы пустую страницу не пришлось трактовать наугад, в ответе появляется блок collecting:

{
  "collecting": {
    "links_total": 2,
    "collecting_total": 1,
    "failed_total": 0,
    "message": "First collection is still running for 1 of 2 platforms — reviews appear here as soon as it finishes."
  },
  "total": 0, "limit": 100, "offset": 0, "has_next": false, "data": []
}

Блок приходит только пока по какой-то площадке не было ни одного успешного сбора. Как только сбор прошёл, ключ пропадает навсегда — даже если отзывов у объекта не оказалось вовсе: пустая выдача без collecting означает, что мы всё собрали и отзывов нет.

Если failed_total больше нуля, первый сбор по этим площадкам не удался; подробности — в полях scrape_status и scrape_error у ссылок объекта (Получить объект).

Ждать готовности удобнее по объекту, а не по отзывам: scrape_status объекта меняется на success, partial или failed, когда сбор закончен — готовый цикл ожидания есть в Быстром старте.

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