Получить отзывы группы

Отзывы группы с фильтрацией, сортировкой и пагинацией (канонические имена /v2).

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

Диапазон дат публикации — published_from/published_to; инкрементальная выборка изменённых — updated_after (по updated_at); фильтр ответа — has_reply.

Authorization

APIKeyHeader

X-API-Key<token>

In: header

Query Parameters

group_id*Group Id

Encoded group ID (required)

link_ids?array<integer>

Filter by link IDs.

Default[]

source_ids?array<integer>

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

Default[]

sort_by?Sort By

Поле сортировки: date (по дате публикации) или rating.

Default"date"

Value in

"date"
"rating"

sort_order?Sort Order

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

Default"desc"

Value in

"desc"
"asc"

min_rating?|

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

max_rating?|

Максимальная оценка включительно, шкала 1–5 (дробное). Пусто — без верхней границы.

published_from?|

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

published_to?|

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

updated_after?|

Только отзывы, изменённые (updated_at) строго ПОСЛЕ этого момента (ISO 8601). Курсор для инкрементальной синхронизации.

has_images?|

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

has_videos?|

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

has_text?|

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

has_reply?|

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

search?|

Поиск подстроки по тексту отзыва (регистронезависимо на проде; < 2 непробельных символов игнорируются).

limit?Limit

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

Range1 <= value <= 1000

Default100

offset?Offset

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

Range0 <= value

Default0

include_raw?Include Raw

Добавить сырые данные площадки (raw_review).

Defaultfalse

include_deleted?Include Deleted

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

Defaultfalse

only_deleted?Only Deleted

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

Defaultfalse

show_hidden?Show Hidden

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

Defaultfalse

show_pinned?Show Pinned

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

Defaultfalse

separate_pos_neg?Separate Pos Neg

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

Defaultfalse

Response Body

`application/json`

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

{  "data": [    {      "id": 0,      "link_id": 0,      "source_id": 0,      "author": "string",      "text": "string",      "review_date": "2019-08-24T14:15:22Z",      "rating_original": "string",      "rating": 0,      "review_url": "string",      "reply_text": "string",      "reply_date": "2019-08-24T14:15:22Z",      "has_images": true,      "images": [],      "has_videos": false,      "videos": [],      "raw_review": {},      "is_deleted": false,      "deleted_at": "2019-08-24T14:15:22Z",      "last_seen_at": "2019-08-24T14:15:22Z",      "updated_at": "2019-08-24T14:15:22Z",      "is_hidden": false,      "is_pinned": false,      "pin_position": 0,      "positive": "string",      "negative": "string"    }  ],  "total": 0,  "limit": 0,  "offset": 0,  "has_next": true}

{  "detail": "string",  "code": "string"}

Получить отзывы группы

Authorization

Query Parameters

Response Body

200application/json

defaultapplication/json

`application/json`

`application/json`