Руководства
Как считать аналитику
Доступ для AI:
Два метода считают агрегаты по объекту или по папке целиком: агрегированная сводка на текущий момент и динамика по периодам.
Оба принимают одни и те же фильтры: group_id либо folder_id (ровно один из двух), source_ids,
границы периода и диапазон оценки.
Периоды считаются по дате публикации отзыва.
Агрегированная сводка
curl "https://api.rewio.ru/v2/analytics?group_id=20" \
-H "X-API-Key: hrev_ВАШ_КЛЮЧ"Ответ состоит из трёх блоков:
meta– какие фильтры фактически применились;summary– общие метрики за период;by_source– те же метрики по каждой площадке отдельно.
Динамика
curl "https://api.rewio.ru/v2/analytics/timeseries?group_id=20&granularity=month" \
-H "X-API-Key: hrev_ВАШ_КЛЮЧ"granularity – шаг ряда: day, week или month.
Ответ: series по площадкам. В каждой точки с меткой периода, числом отзывов, средней
оценкой и распределениями.
Без явных границ ряд строится за последние 90 дней, а не за всю историю. И ряд начинается
с первого целого интервала: при шаге в месяц и published_from=2026-05-06 мая в ряду не будет
совсем; ставьте начало периода на первое число.
import requests
BASE = "https://api.rewio.ru/v2"
HEADERS = {"X-API-Key": "hrev_ВАШ_КЛЮЧ"}
r = requests.get(f"{BASE}/analytics/timeseries", headers=HEADERS, params={
"group_id": 20, "granularity": "month",
"published_from": "2025-08-01", "published_to": "2026-08-01",
})
for series in r.json()["series"]:
print(series["source_name"])
for point in series["timeseries"]:
print(f" {point['period']}: {point['avg_rating']} ({point['review_count']} отз.)")