REST API v1
MegaStat API
Каналы MAX, метрики, посты, упоминания и реклама в JSON. Те же инструменты, что у агента и MCP-сервера. Спецификация OpenAPI 3.1: /v1/openapi.json.
Авторизация
Создайте ключ в «Настройки › API» и передавайте его в заголовке. Ключ привязан к воркспейсу и скоупам; показывается один раз.
curl -H "Authorization: Bearer ms_live_XXXXXXXX_…" \ "https://mcp.mega-stat.ru/v1/channels/search?query=новости&limit=10"
Также принимается X-API-Key и OAuth access token (aud https://mcp.mega-stat.ru/v1). Ошибки — application/problem+json (RFC 9457).
Лимиты
Не больше 10 запросов в секунду на ключ и месячная квота тарифа (Free 1 000, Pro 20 000, Team 200 000, Agency 1 000 000). Остаток — в заголовках X-Quota-Remaining, X-Quota-Reset, RateLimit-*; при превышении — 429.
Методы
| Метод | Путь | Что возвращает | Скоуп |
|---|---|---|---|
| GET | /v1/ads | Рекламные размещения Рекламные посты с маркировкой erid: по каналу, по ИНН рекламодателя или по erid (без фильтров — последние по рынку). | channels:read |
| GET | /v1/advertisers | Рекламодатели Рекламодатели в MAX по маркировке: поиск по названию или ИНН, число размещений и каналов, первое и последнее размещение. | channels:read |
| GET | /v1/channels/{channel} | Карточка канала Карточка одного канала MAX: подписчики, прирост, охват поста за 24 и 72 ч, ERR24, посты за 7 и 30 дней, входящие упоминания и реклама за 30 дней, рубрика, свежесть данных (asOf) и полнота истории. | channels:read |
| GET | /v1/channels/{channel}/graph | Граф цитирования Граф цитирования вокруг канала: узлы — каналы, которые упоминают его или которых упоминает он, рёбра с весом (число упоминаний за период), плюс связи между соседями. | channels:read |
| GET | /v1/channels/{channel}/mentions | Упоминания Упоминания канала: in — кто ссылался на канал или репостил его, out — на кого ссылался сам канал. | channels:read |
| GET | /v1/channels/{channel}/posts | Посты канала Посты канала: свежие или самые просматриваемые, можно только рекламные (erid) и за N дней. | channels:read |
| GET | /v1/channels/{channel}/similar | Похожие каналы Каналы, похожие на заданный: их упоминают те же источники (совместное цитирование); если сигнала мало — каналы той же рубрики близкого размера. | channels:read |
| GET | /v1/channels/{channel}/timeseries | Динамика канала Дневной ряд метрики канала за последние N дней: подписчики, посты, просмотры, средний охват 24 ч, ERR24, входящие упоминания, рекламные посты. | channels:read |
| POST | /v1/channels/compare | Сравнение каналов Сравнение 2–10 каналов: карточки с KPI (подписчики, прирост, охват, ERR, посты, упоминания, реклама) в порядке запроса. | channels:read |
| GET | /v1/channels/search | Поиск каналов Поиск каналов MAX в каталоге MegaStat по названию, username или теме и фильтрам (рубрика, подписчики, ERR, реклама). | channels:read |
| GET | /v1/posts/search | Поиск постов Полнотекстовый поиск постов каналов MAX: все слова запроса (регистр и ё не важны) или точная фраза в кавычках. | channels:read |
| POST | /v1/reports | Создать отчёт Сохраняет отчёт, дашборд или таблицу как артефакт MegaStat по декларативной спецификации (блоки kpi, line/bar/area, table, channel_card, post_list, mention_feed, graph, mediaplan, markdown; данные блоков — query: {tool, args} к инструментам чтения). | reports:write |
| GET | /v1/usage | Тариф и лимиты Тариф воркспейса, лимиты и остатки квот (AI-сообщения, вызовы MCP и API, экспорт) в текущем периоде. | account:read |