Продукты, лимиты и ошибки

Продукты

Продукт	Что входит	Методы
API Stat	Каталог и карточки каналов, чатов и ботов, подписчики по дням, охваты и ERR, лента канала и разбор поста, индекс цитирования, сводка по рынку	Все методы, кроме перечисленных ниже
API Search	Полнотекстовый поиск по публикациям и упоминания каналов	`/api/posts/search`, `/api/channels/mentions-timeline`, `/api/channels/mentions-list`

Если метод входит в продукт, который не подключён к ключу, сервер ответит 403 с кодом product.

Месячная квота — сколько запросов ключ может сделать за календарный месяц по московскому времени. Каждый успешный запрос к REST-API и каждый вызов инструмента MCP — один запрос. Квота общая для REST и MCP.
Лимит в минуту — защита от зацикленных скриптов и агентов. По умолчанию 120 запросов в минуту на ключ.

Размер квоты и лимита задаётся при выдаче ключа. Расход виден в профиле, а в MCP — через инструмент get_account_usage, который квоту не тратит.

Запросы учитываются пачками раз в несколько секунд, поэтому на границе квоты возможен небольшой перебор — не больше нескольких запросов.

Код	`error`	Что случилось	Что делать
`200`	—	Успех	—
`401`	`unauthorized`	Ключ не передан, не найден, отозван или у него выключен REST	Проверьте заголовок `X-API-Key` и ключ в профиле
`403`	`product`	Метод входит в продукт, который не подключён к ключу	Напишите нам, чтобы подключить продукт
`404`	`not_found`	Канал или пост не найден	Проверьте `handle`, `chat_id` или `seq`
`429`	`rate_limit`	Превышен лимит запросов в минуту	Подождите минуту, добавьте паузы между запросами
`429`	`quota`	Исчерпана месячная квота	Дождитесь нового месяца или попросите увеличить квоту
`5xx`	—	Временная ошибка сервера	Повторите запрос с паузой: 1, 2, 4 секунды

Тело ответа с ошибкой — JSON:

{
  "error": "quota",
  "message": "Исчерпана месячная квота (5000 запросов)."
}

Формат — JSON в кодировке UTF-8, методы только читают данные (GET).
Время — поля *_epoch и epoch в секундах Unix, поля when — строка по Москве в формате ДД.ММ.ГГГГ ЧЧ:ММ, даты рядов d — ГГГГ-ММ-ДД.
Каналы адресуются слагом из ссылки max.ru/… (handle) или числовым chat_id. У каналов и чатов chat_id отрицательный.
Посты адресуются парой chat_id + seq. seq — строка: число не помещается в double без потери точности.
Данные — только публичные каналы, чаты и боты. Закрытые и замороженные каналы в выдачу не попадают.