---
title: "Динамика отзывов по периодам"
method: GET
path: "/v3/analytics/timeseries"
tags: ["analytics"]
---

# Динамика отзывов по периодам

`GET /v3/analytics/timeseries`

## Request

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

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

Ряды приходят в `series`, точки каждого ряда — в `points`. `source_id = 0`
означает агрегированный ряд по всем площадкам.

## Query parameters

- `folder_id` integer, nullable: Папка целиком: все её объекты и объекты подпапок. Взаимоисключима с `object_id` — ровно один из двух.
- `object_id` integer, nullable: Идентификатор объекта. Взаимоисключим с `folder_id`.
- `source_ids` integer[]: Площадки для разбивки; `0` — агрегированный ряд. По умолчанию `[0]`.
- `granularity` 'day' | 'week' | 'month': Размер интервала: `day` / `week` / `month`.
- `published_from` string, date, nullable: Начало периода по дате публикации, включительно. По умолчанию 90 дней назад.
- `published_to` string, date, nullable: Конец периода по дате публикации, включительно. По умолчанию сегодня.
- `min_rating` number: Нижняя граница оценки (1–5). `0` — без нижней границы и вместе с отзывами без оценки.
- `max_rating` number: Верхняя граница оценки (1–5).

## Response `200`

Successful Response

- TimeseriesResponseV3: Динамика отзывов по интервалам.
  - `meta` TimeseriesMetaV3, 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).
    - `granularity` string, required: Применённый размер интервала ряда: `day`, `week` или `month`.
  - `series` TimeseriesSeriesV3[], required
    - `source_id` integer, required: Идентификатор площадки ряда; `0` — агрегированный ряд по всем площадкам.
    - `source_name` string, required: Название площадки; для `source_id = 0` — «Все источники».
    - `points` TimeseriesPointV3[], required: Точки ряда в хронологическом порядке.
      - `period` string, required: Начало интервала: `YYYY-MM-DD` для дня и недели, `YYYY-MM` для месяца.
      - `review_count` integer, required: Число отзывов в этом интервале.
      - `average_rating` number, nullable: Средняя оценка в интервале, шкала 1–5.
      - `reply_count` integer, nullable: Число ответов организации в интервале.
      - `reviews_with_text` integer, nullable: Сколько отзывов интервала с текстом.
      - `reviews_with_images` integer, nullable: Сколько отзывов интервала с изображениями.
      - `rating_distribution` object, nullable: Распределение отзывов интервала по оценкам.
      - `reply_distribution` object, 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)