Статистика

Статистика по дням

Статистика каналов по дням (день — по московскому времени): подписчики на конец дня, число постов, просмотры и реакции постов этого дня, рекламные посты. До 100 каналов за запрос (номера через запятую в channels), период from–to включительно — до 366 дней (по умолчанию последние 30), строк «каналов × дней» — до 10 000. Строки идут по каналу, затем по дню; каналы, которых нет или которые вам не видны, — списком в not_found. Тарифу «API.Max Тест» — только 30 последних дней (раньше — 403 tariff_required).

Параметры

Имя параметра	Где	Описание
channels обязателен строка	запрос	До 100 номеров каналов через запятую
from дата	запрос	Первый день (ГГГГ-ММ-ДД); по умолчанию — 30 дней назад
to дата	запрос	Последний день (ГГГГ-ММ-ДД); по умолчанию — сегодня

Поля ответа

Поле	Тип	Описание
results	список	Строки «канал × день» по порядку: канал, затем день
results[].channel	число	Номер канала в datool.ru
results[].day	дата	День по московскому времени
results[].subscribers	число или null	Подписчиков на конец дня; null — в этот день канал не опрашивали
results[].posts	число	Постов за день
results[].views	число	Просмотров постов этого дня
results[].reactions	число	Реакций на посты этого дня
results[].ad_posts	число	Рекламных постов за день
not_found	список	Номера из запроса, которых нет или которые ключу не видны

Ошибки

Код	code	Когда
400	ошибки полей	Неверный параметр или поле тела: ошибка приходит у имени поля, например {"channels": ["Номера каналов через запятую."]}.
401	not_authenticated / authentication_failed	Нет ключа, ключ неверный или отозван, участник приостановлен или организация ключа в архиве.
403	tariff_required	На тарифе «API.Max Тест» — дата раньше 30 последних дней.
429	rate_limited / quota_exceeded / throttled	Слишком часто (больше запросов в секунду, чем по тарифу) или запросы за период закончились; сколько ждать — в заголовке Retry-After.
503	timeout	Запрос к базе не уложился в 5 секунд — повторите позже или сузьте выборку.