---
title: "Сводная аналитика объекта, папки или аккаунта"
method: GET
path: "/v3/analytics"
tags: ["analytics"]
---

# Сводная аналитика объекта, папки или аккаунта

`GET /v3/analytics`

## Request

- Base URL: `https://api.rewio.ru`
- URL: `https://api.rewio.ru/v3/analytics`
- Auth: API key in header `X-API-Key`

Сводная аналитика по отзывам за период — по объекту или по папке целиком.

Адресат — `object_id`, `folder_id` или **ничего**: тогда считается по всем
включённым объектам аккаунта. Объект и папка сразу — `400 object_and_folder_conflict`.

В папочном режиме считается по всем объектам папки и её подпапок; ссылка,
лежащая в нескольких объектах папки, учитывается один раз. `by_source`
схлопывает одну площадку разных объектов в одну строку с суммой.
`meta.object_ids` показывает фактический состав расчёта.

## Query parameters

- `folder_id` integer, nullable: Папка целиком: все её объекты и объекты подпапок. Взаимоисключима с `object_id` — ровно один из двух.
- `object_id` integer, nullable: Идентификатор объекта. Взаимоисключим с `folder_id`.
- `source_ids` integer[]: Фильтр по площадкам (id из `GET /v3/sources`). Пусто — все площадки объекта.
- `published_from` string, date, nullable: Начало периода по дате публикации, включительно (`YYYY-MM-DD`). По умолчанию `2000-01-01`.
- `published_to` string, date, nullable: Конец периода по дате публикации, включительно (`YYYY-MM-DD`). По умолчанию сегодня.
- `min_rating` number: Нижняя граница оценки (1–5), включительно. `0` — без нижней границы и **вместе с отзывами без оценки**.
- `max_rating` number: Верхняя граница оценки (1–5), включительно.

## Response `200`

Successful Response

- AnalyticsResponseV3: Сводная аналитика объекта или папки.
  - `meta` AnalyticsMetaV3, required: Что именно посчитано — фактически применённые адресат и фильтры.
    - `object_id` integer, nullable: Объект, по которому считали. `null` в папочном режиме.
    - `folder_id` integer, nullable: Папка, по которой считали. `null` в объектном режиме.
    - `object_ids` integer[], required: Объекты, вошедшие в расчёт. В объектном режиме — один.
    - `published_from` string, date, required: Фактически применённое начало периода по дате публикации, включительно.
    - `published_to` string, date, required: Фактически применённый конец периода, включительно.
    - `source_ids` integer[], required: Фактически применённый фильтр по площадкам. Пусто — все площадки объекта.
    - `generated_at` string, date-time, required: Момент расчёта данных (UTC, ISO 8601).
  - `summary` AnalyticsSummaryV3, required: Сводка за период.
    - `review_count` integer, required: Всего отзывов за период с учётом фильтров.
    - `average_rating` number, nullable: Средняя оценка по шкале 1–5, округлённая до сотых. `null`, если отзывов нет.
    - `reviews_with_text` integer, nullable: Сколько из них с текстом.
    - `reviews_with_images` integer, nullable: Сколько из них с изображениями.
    - `rating_distribution` object, nullable: Распределение отзывов по оценкам.
    - `reply` ReplyStatsV3: Сводка по ответам организации.
      - `reviews_with_reply` integer, required: Число отзывов, на которые есть ответ организации.
      - `unanswered_negative_count` integer, required: Число отзывов с низкой оценкой без ответа.
      - `reply_by_rating` object, nullable: Распределение отвеченных отзывов по оценкам.
      - `last_reply_date` string, date, nullable: Дата самого свежего ответа организации.
  - `by_source` BySourceItemV3[], required
    - `source_id` integer, required: Идентификатор площадки (см. `GET /v3/sources`).
    - `source_name` string, required: Название площадки для показа человеку.
    - `review_count` integer, required: Число отзывов с этой площадки за период.
    - `average_rating` number, nullable: Средняя оценка по этой площадке, шкала 1–5.
    - `reviews_with_reply` integer, nullable: Сколько из них с ответом организации.
    - `reviews_with_text` integer, nullable: Сколько из них с текстом.
    - `reviews_with_images` integer, nullable: Сколько из них с изображениями.
    - `rating_distribution` object, nullable: Распределение отзывов по оценкам.
    - `reply_distribution` object, nullable: Распределение отвеченных отзывов по оценкам.
    - `latest_review_date` string, date, nullable: Дата самого свежего отзыва с этой площадки за период.
  - `access` AccessInfoV3: Выдача ограничена тарифом — показано не всё.
    - `reason` string, required: Почему выдача ограничена. `trial` — пробный доступ, `manual` — ограничение, согласованное по вашему договору.
    - `limit_per_link` integer, required: Сколько последних отзывов показывается по КАЖДОЙ ссылке (площадке объекта).
    - `hidden_total` integer, required: Сколько отзывов уже собрано сверх показанных. Считается по всему архиву и не зависит от фильтров запроса.
    - `message` string, required: Готовая формулировка для показа человеку.

## Other responses

- `default`: Error

---

[API](https://skmtc.dev/rewio/apis/review-aggregator.md) · [All operations](https://skmtc.dev/rewio/apis/review-aggregator/llms.txt) · [OpenAPI document](https://skmtc.dev/rewio/apis/review-aggregator/revisions/9222b6cf28a5?raw)