Аналитика и динамика

Два эндпоинта дают агрегаты по группе, не выкачивая отзывы по одному:

• GET /v2/analytics — сводка на текущий момент.
• GET /v2/analytics/timeseries — динамика по периодам.

Оба принимают одни и те же фильтры: group_id (обязателен), source_ids, published_from / published_to, min_rating / max_rating.

Сводка

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

Ответ содержит:

• summary — общие метрики: total_reviews, avg_rating, reviews_with_text, reviews_with_images, распределение по оценкам (rating_distribution) и блок ответов (reply: сколько с ответом, сколько негатива без ответа, дата последнего ответа).
• by_source — те же метрики в разрезе каждой площадки (source_name, review_count, avg_rating, latest_review_date и т. д.).

Типичное применение — карточка объекта: средняя оценка, количество отзывов, доля отвеченного негатива.

Динамика по периодам

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

• granularity — размер корзины: day / week / month (по умолчанию month).
• Ответ — series по площадкам; в каждой timeseries — точки с period, review_count, avg_rating, reviews_with_text, reply_count и распределениями.

Пример — построить график средней оценки по месяцам за год:

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-07-01", "published_to": "2026-07-01",
})
for series in r.json()["series"]:
    print(series["source_name"])
    for pt in series["timeseries"]:
        print(f"  {pt['period']}: {pt['avg_rating']} ({pt['review_count']} отз.)")

Полные схемы ответов — в справочнике: GET /v2/analytics и GET /v2/analytics/timeseries.