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

Те же метрики, что и в сводке, разложенные по дням, неделям или месяцам.

Ряд начинается с первого целого интервала. При шаге в месяц и published_from=2026-05-06 май в ряд не попадёт совсем – чтобы увидеть его, начните период с первого числа.

Параметры

folder_idчисло

Папка целиком: все её объекты и подпапки. Вместе с object_id не передаётся.

object_idчисло

Объект, по которому строить ряд.

source_idsсписок чиселпо умолчанию пусто

Отдельный ряд на каждую из этих площадок. По умолчанию 0: общий ряд по всем.

granularityстрокаday / week / monthпо умолчанию «month»

Шаг ряда: по дням, неделям или месяцам.

published_fromдата

Начало периода по дате публикации отзыва. По умолчанию 90 дней назад.

published_toдата

Конец периода по дате публикации. По умолчанию сегодня.

min_ratingчисло0–5по умолчанию 1

Учитывать отзывы с оценкой не ниже указанной.

max_ratingчисло1–5по умолчанию 5

Учитывать отзывы с оценкой не выше указанной.

Ответ

seriesсписок объектов

Ряды, по одному на каждую запрошенную площадку.

series[].source_idчисло

Площадка ряда. 0 – общий ряд по всем площадкам.

series[].source_nameстрока

Название площадки. У общего ряда это «Все источники».

series[].pointsсписок объектов

Точки ряда по возрастанию времени.

series[].points[].periodстрока

Метка интервала: 2026-08-04 для дня, 2026-W32 для недели, 2026-08 для месяца.

series[].points[].review_countчисло

Сколько отзывов пришло за интервал.

series[].points[].average_ratingчисломожет быть пустым

Средняя оценка за интервал.

series[].points[].reply_countчисломожет быть пустым

Сколько отзывов получили ответ организации.

series[].points[].rating_distributionобъектможет быть пустым

Распределение отзывов интервала по оценкам.

accessобъектможет быть пустым

Ограничение выдачи, если показали не всё.

access.reasonстрока

Почему выдача ограничена. trial — пробный доступ, manual — ограничение, согласованное по вашему договору.

access.limit_per_linkчисло

Сколько последних отзывов показывается по КАЖДОЙ ссылке (площадке объекта).

access.hidden_totalчисло

Сколько отзывов уже собрано сверх показанных. Считается по всему архиву и не зависит от фильтров запроса.

access.messageстрока

Готовая формулировка для показа человеку.

Ещё 12 полей – реже нужны

metaобъект

Что именно посчитано: фильтры в том виде, в котором применились.

meta.object_idчисломожет быть пустым

Объект, по которому посчитано. В папочном режиме пусто.

meta.folder_idчисломожет быть пустым

Папка, если считали по папке.

meta.object_idsсписок чисел

Все объекты, попавшие в расчёт.

meta.published_fromдата

Начало периода, которое применилось.

meta.published_toдата

Конец периода, который применился.

meta.source_idsсписок чисел

Площадки, которые применились.

meta.generated_atдата и время

Когда посчитано.

meta.granularityстрока

Шаг ряда, который применился.

series[].points[].reviews_with_textчисломожет быть пустым

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

series[].points[].reviews_with_imagesчисломожет быть пустым

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

series[].points[].reply_distributionобъектможет быть пустым

Распределение ответов организации по оценке отзыва.

curl -X GET "https://example.com/v3/analytics/timeseries"

{  "meta": {    "object_id": 20,    "folder_id": null,    "object_ids": [      20    ],    "published_from": "2026-05-01",    "published_to": "2026-08-01",    "source_ids": [      0    ],    "generated_at": "2026-08-25T05:52:21.664180Z",    "granularity": "month"  },  "series": [    {      "source_id": 0,      "source_name": "Все источники",      "points": [        {          "period": "2026-05",          "review_count": 69,          "average_rating": 4.47,          "reply_count": 43,          "reviews_with_text": 51,          "reviews_with_images": 7,          "rating_distribution": {            "1": 5,            "2": 0,            "3": 3,            "4": 17,            "5": 44          },          "reply_distribution": {            "1": 4,            "2": 0,            "3": 1,            "4": 9,            "5": 29          }        },        {          "period": "2026-06",          "review_count": 87,          "average_rating": 4.28,          "reply_count": 48,          "reviews_with_text": 72,          "reviews_with_images": 11,          "rating_distribution": {            "1": 4,            "2": 3,            "3": 15,            "4": 20,            "5": 45          },          "reply_distribution": {            "1": 3,            "2": 2,            "3": 6,            "4": 7,            "5": 30          }        },        {          "period": "2026-07",          "review_count": 71,          "average_rating": 4.42,          "reply_count": 47,          "reviews_with_text": 54,          "reviews_with_images": 14,          "rating_distribution": {            "1": 5,            "2": 2,            "3": 5,            "4": 13,            "5": 46          },          "reply_distribution": {            "1": 3,            "2": 0,            "3": 4,            "4": 8,            "5": 32          }        },        {          "period": "2026-08",          "review_count": 0,          "average_rating": null,          "reply_count": null,          "reviews_with_text": null,          "reviews_with_images": null,          "rating_distribution": null,          "reply_distribution": null        }      ]    }  ]}

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