reviews

Получить отзывы объекта или папки

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

Адресат — object_id (один объект), folder_id (папка целиком) или ничего: тогда лента идёт по всем включённым объектам аккаунта. Объект и папка сразу — 400 object_and_folder_conflict.

Ответ — конверт Page: {data, total, limit, offset, has_next}. По каждому отзыву: author, text, rating (шкала 1–5), reply_text / reply_date, images и остальное.

Сортировка: sort_by=review_date (по умолчанию), rating или reply_date. Отзывы без ответа идут в конце при обоих направлениях, поэтому «сначала неотвеченные» — это не сортировка, а has_reply=false.

get/v3/reviews

Request

  • Base URL: https://api.rewio.ru
  • URL: https://api.rewio.ru/v3/reviews
  • Auth: API key in header X-API-Key

Query parameters

folder_idinteger nullable

Единая лента по всей папке: все объекты папки и её подпапок. Взаимоисключим с object_id; без обоих — лента всего аккаунта. Выключенные и удалённые объекты в состав не входят. В папочном режиме закрепления не применяются, а скрытия применяются по составу папки.

object_idinteger nullable

Идентификатор объекта. Взаимоисключим с folder_id — в запросе должен быть ровно один из двух.

link_idsinteger[]

Filter by link IDs.

source_idsinteger[]

Фильтр по площадкам: id из GET /v3/sources. Пусто — все площадки объекта.

sort_by'review_date' | 'rating' | 'reply_date'

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

sort_order'desc' | 'asc'

Направление сортировки: desc / asc.

min_ratingnumber nullable

Минимальная оценка включительно, шкала 1–5. 0 — без нижней границы и вместе с отзывами без оценки.

max_ratingnumber nullable

Максимальная оценка включительно, шкала 1–5.

published_fromstring date nullable

Нижняя граница по дате публикации (review_date), включительно. Формат YYYY-MM-DD.

published_tostring date nullable

Верхняя граница по дате публикации (review_date), включительно. Формат YYYY-MM-DD.

has_imagesboolean nullable

Фильтр по наличию изображений.

has_videosboolean nullable

Фильтр по наличию видео.

has_textboolean nullable

Фильтр по наличию текста отзыва.

has_replyboolean nullable

Фильтр по наличию ответа организации.

searchstring nullable

Поиск подстроки по тексту отзыва (регистронезависимо).

limitinteger

Размер страницы (1–1000). По умолчанию 100.

offsetinteger

Смещение для пагинации.

show_deletedboolean

Показывать отзывы, помеченные удалёнными на площадке.

only_deletedboolean

Только удалённые отзывы (приоритет над show_deleted).

show_hiddenboolean

Показывать скрытые отзывы (с флагом is_hidden).

show_pinnedboolean

Показывать закреплённые отзывы (с флагом is_pinned).

split_pros_consboolean

Разбирать слитый текст на pros / cons.

Response

Successful Response

totalinteger required

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

limitinteger required

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

offsetinteger required

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

has_nextboolean required

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

Example response

{
  "data": [
    {
      "images": [
        {
          "image": "https://avatars.mds.yandex.net/get-altay/17743308/2a0000019f85dc34d7ee3b24b4b9ec82bdbd/XXXL",
          "preview": "https://avatars.mds.yandex.net/get-altay/17743308/2a0000019f85dc34d7ee3b24b4b9ec82bdbd/M",
          "template_url": "https://avatars.mds.yandex.net/get-altay/17743308/2a0000019f85dc34d7ee3b24b4b9ec82bdbd/{size}"
        }
      ]
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.