Забрать отзывы

Все отзывы читаются одним эндпоинтом — GET /v2/reviews — с обязательным group_id и набором фильтров. Ответ всегда пагинированный: {data, total, limit, offset, has_next}.

Минимальный запрос

curl "https://api.rewio.ru/v2/reviews?group_id=20&limit=20" \
  -H "X-API-Key: hrev_ВАШ_КЛЮЧ"

Пагинация

Смещение задаётся limit (по умолчанию 100) и offset (по умолчанию 0). Признак «есть ещё» — булев has_next; общее число под текущими фильтрами — total.

import requests

BASE = "https://api.rewio.ru/v2"
HEADERS = {"X-API-Key": "hrev_ВАШ_КЛЮЧ"}

def iter_reviews(group_id, **filters):
    offset, limit = 0, 100
    while True:
        r = requests.get(f"{BASE}/reviews", headers=HEADERS, params={
            "group_id": group_id, "limit": limit, "offset": offset, **filters,
        })
        r.raise_for_status()
        page = r.json()
        yield from page["data"]
        if not page["has_next"]:
            break
        offset += limit

for rev in iter_reviews(20, min_rating=1, max_rating=3):
    print(rev["rating"], rev["author"])

Сортировка

sort_by — date (по умолчанию; это review_date) или rating.
sort_order — desc (по умолчанию) или asc.

Фильтры

Все фильтры комбинируются по И (AND).

Параметр	Смысл
`source_ids`	Оставить только указанные площадки (повторяемый параметр).
`link_ids`	Оставить только указанные ссылки.
`min_rating` / `max_rating`	Диапазон нормализованной оценки 1–5 (включительно).
`published_from` / `published_to`	Диапазон даты публикации (`review_date`), включительно.
`updated_after`	Курсор: что изменилось у нас после момента (UTC). См. инкрементальную синхронизацию.
`has_text`	`true` — только отзывы с непустым текстом.
`has_images` / `has_videos`	`true` — только с фото / видео.
`has_reply`	`true` — только с ответом объекта.
`search`	Полнотекстовый поиск по тексту отзыва.

Пример — негатив с фото за квартал по двум площадкам:

curl -G "https://api.rewio.ru/v2/reviews" \
  -H "X-API-Key: hrev_ВАШ_КЛЮЧ" \
  --data-urlencode "group_id=20" \
  --data-urlencode "max_rating=3" \
  --data-urlencode "has_images=true" \
  --data-urlencode "published_from=2026-04-01" \
  --data-urlencode "published_to=2026-06-30" \
  --data-urlencode "source_ids=1" \
  --data-urlencode "source_ids=2"

Спец-флаги

include_raw=true — добавить сырой ответ площадки (raw_review) для отладки.
include_deleted=true / only_deleted=true — показать удалённые на площадке отзывы (по умолчанию скрыты). Удалённый помечен is_deleted.
show_hidden=true / show_pinned=true — показать пометки показа (скрытые / закреплённые отзывы) в выдаче.
separate_pos_neg=true — для площадок, где плюсы и минусы отзыва разнесены, вернуть их отдельными полями positive / negative.

Полное описание каждого параметра и схему ответа смотрите в справочнике GET /v2/reviews с интерактивным try-it.