Документация API v2. Версия заморожена и продолжает работать; актуальная — на главной. Что изменилось: переход с v2 на v3.
Вебхуки

Создать вебхук

Доступ для AI:

Rewio отправляет события на ваш адрес, когда появляются новые отзывы.

Каждая доставка подписана заголовком X-Hrev-Signature. Секрет общий на все вебхуки аккаунта – заберите его на отдельной странице.

POST
/v2/webhooks

Тело запроса

targetстрокаобязательный

Адрес, на который слать события. Только HTTPS.

group_idsсписок чисел

Объекты, события которых доставлять. Не передано – все ваши объекты, включая будущие.

event_typesсписок строк

Какие события доставлять: reviews.new, replies.new, scrape.run.finished.

bucket_windowстрокапо умолчанию «immediate»

Как часто доставлять: immediate – сразу после сбора, daily_<час> – сводкой в указанный час UTC (daily_09).

filtersобъект

Что доставлять, а что пропускать. Условия складываются: событие проходит, только если выполнены все.

filters.allowed_ratingsсписок чисел

Доставлять только отзывы с этими оценками. Пусто – с любыми.

filters.allowed_sourcesсписок строк

Доставлять только с этих площадок, машинными именами из справочника. Пусто – со всех.

filters.has_textда/нетпо умолчанию нет

Доставлять только отзывы с текстом.

filters.has_imagesда/нетпо умолчанию нет

Доставлять только отзывы с фотографиями.

Ответ

idчисло

Идентификатор созданного вебхука.

targetстрока

Адрес, на который приходят события.

group_idsсписок чиселможет быть пустым

Объекты, события которых доставляются.

event_typesсписок строк

Какие события доставляются.

bucket_windowстрока

Как часто доставляются.

filtersобъект

Применённые фильтры доставки.

filters.allowed_ratingsсписок чисел

Оценки, при которых доставлять.

filters.allowed_sourcesсписок строкможет быть пустым

Площадки, при которых доставлять.

filters.has_textда/нет

Только отзывы с текстом.

filters.has_imagesда/нет

Только отзывы с фотографиями.

is_activeда/нет

Включена ли доставка.

failure_countчисло

Сколько неудачных доставок подряд.

last_failure_atдата и времяможет быть пустым

Когда доставка не удалась в последний раз.

created_atдата и время

Когда вебхук создан.

updated_atдата и время

Когда его меняли в последний раз.

curl -X POST "https://example.com/v2/webhooks" \  -H "Content-Type: application/json" \  -d '{    "target": "https://example.com/hooks/rewio",    "group_ids": [      20    ],    "event_types": [      "reviews.new",      "replies.new"    ],    "bucket_window": "immediate",    "filters": {      "allowed_ratings": [        1,        2,        3      ],      "has_text": true    }  }'
{  "id": 41,  "target": "https://example.com/hooks/rewio",  "group_ids": [    20  ],  "event_types": [    "reviews.new",    "replies.new"  ],  "bucket_window": "immediate",  "filters": {    "allowed_ratings": [      1,      2,      3    ],    "allowed_sources": null,    "has_text": true,    "has_images": false  },  "is_active": true,  "failure_count": 0,  "last_failure_at": null,  "created_at": "2026-08-01T09:14:02",  "updated_at": "2026-08-01T09:14:02"}

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