API документация

REST API для автоматического получения статистики каналов MAX.

Аутентификация

Передавай API ключ в заголовке каждого запроса:

Authorization: Bearer YOUR_API_KEY

API ключ доступен в личном кабинете для тарифов Pro и API.

Базовый URL

https://maxstat.ru

Эндпоинты

GET/api/v1/channels/{username}/stats

Получить текущую статистику канала

Параметры
ПараметрТипОписание
usernamepathUsername канала (без @)
Ответ
{
  "username": "example",
  "subscribers": 45200,
  "avg_views_48h": 12400.5,
  "avg_views_7d": 11800.2,
  "avg_views_30d": 10500.0,
  "err_48h": 27.43,
  "err_7d": 26.1,
  "err_30d": 23.2,
  "er": 1.24,
  "posts_count_7d": 14,
  "citation_index": 8.5,
  "updated_at": "2024-05-20T12:00:00+00:00"
}
GET/api/v1/rating

Топ каналов по ERR

Параметры
ПараметрТипОписание
categoryqueryФильтр по категории (slug)
limitqueryКоличество результатов (макс. 200)
Ответ
[
  {
    "username": "example",
    "subscribers": 45200,
    "err_48h": 27.43,
    ...
  }
]

Лимиты запросов

Pro1 000 / день
API10 000 / день