МетриусAPI v1
Metrius API

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

Используйте API Метриуса, чтобы получать список каналов, метрики, посты, комментарии, аудиторию, трафик, мониторинг и добавлять Telegram/MAX-каналы из внешних систем.

Получить API-ключОткрыть методыСкачать OpenAPI

Быстрый старт

Получите API-ключ в Метриусе и передавайте его в заголовке Authorization. Базовый адрес API:

https://metrius.pro/api/v1
Получить API-ключ
API-ключ привязан к пользователю и workspace. Клиент видит только каналы, доступные этому workspace.

Авторизация

Все методы API требуют Bearer-токен.

Accept: application/json
Authorization: Bearer <api_key>

Права API-ключа

ПравоЧто разрешает
channels:readЧитать список и карточки каналов.
channels:writeДобавлять Telegram-каналы.
metrics:readЧитать сводные метрики и временные ряды.
posts:readЧитать посты и детализацию поста.
content:readЧитать контентную аналитику, рубрики и экспресс-анализ.
subscribers:readЧитать детализацию подписок и отписок.
comments:readЧитать комментарии.
traffic:readЧитать трафик, ссылки и кампании.
monitoring:readЧитать мониторинг аномалий.
limits:readЧитать лимиты и историю API-запросов.

Примеры запросов

Получить список каналов

curl -H "Authorization: Bearer $METRIUS_API_TOKEN" \
  -H "Accept: application/json" \
  "https://metrius.pro/api/v1/channels"

Добавить Telegram-канал

curl -X POST "https://metrius.pro/api/v1/channels" \
  -H "Authorization: Bearer $METRIUS_API_TOKEN" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{"provider":"telegram","link":"https://t.me/channel_username","prepare_bot":true}'

Добавить MAX-канал

curl -X POST "https://metrius.pro/api/v1/channels" \
  -H "Authorization: Bearer $METRIUS_API_TOKEN" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{"provider":"max","link":"https://max.ru/channel_name","prepare_bot":true}'

Получить посты за период

curl -H "Authorization: Bearer $METRIUS_API_TOKEN" \
  -H "Accept: application/json" \
  "https://metrius.pro/api/v1/channels/channel_username/content/posts?from=2026-07-01&to=2026-07-07&page=1&per_page=20"

Формат ответа

Большинство методов возвращает данные в едином формате:

{
  "data": {},
  "meta": {
    "from": "2026-07-01",
    "to": "2026-07-07",
    "timezone": "Europe/Moscow"
  }
}

Коды ошибок

КодЗначение
200Запрос выполнен успешно.
201Канал создан.
401API-ключ не передан или неверный.
403Недостаточно прав API-ключа или нет доступа к ресурсу.
404Канал или объект не найден.
409Канал уже подключен другим владельцем.
422Некорректные параметры запроса.
429Превышен лимит запросов.

Справочник методов

Интерактивная документация собрана из OpenAPI-спецификации. Ее можно использовать в Swagger UI, Postman и других API-клиентах.