Лимиты и расход
Сколько стоит запрос
Каждый запрос — 1 единица, сколько бы строк он ни вернул: страница из 100 постов или статистика по 100 каналам — тоже 1. Бесплатно (0 единиц): /v1/me/, справочники рубрик и территорий, управление вебхуками. Сколько стоит метод — на его странице в справочнике.
Лимит на период
Лимит считается за период 30 дней с момента оплаты тарифа: оплатили 18.10 — период до 17.11, потом следующий. Остаток не переносится.
| Тариф | Запросов за период | В секунду | Ключей |
|---|---|---|---|
| API.Max Тест | 1 000 | 1 | 1 |
| API.Max Старт | 100 000 | 5 | 2 |
| API.Max Рост | 300 000 | 10 | 5 |
| API.Max Профи | 1 500 000 | 20 | 20 |
В подписку «Бизнес» (MAX) входит 10 000 запросов за период, 5 в секунду и 2 ключа; методы открыты как на «API.Max Старт».
Заголовки ответа
X-Quota-Limit,X-Quota-Remaining— лимит периода и остаток;X-Quota-Reset— когда начнётся новый период (время в UTC,…Z);X-RateLimit-Limit,X-RateLimit-Remaining— скорость в секунду.
Если лимит кончился
API отвечает кодом 429. Можно купить пакет: 100 000 запросов на 30 дней — они тратятся только после лимита тарифа. Пакеты — на странице «API-ключи» в кабинете.
К сведению
Лимит не тратят запросы без ключа или с неверным ключом (401), отклонённые по лимиту (429) и не выполненные по нашей вине (500, таймаут 503). Остальные ответы, в том числе 400, 403 и 404, стоят как обычный запрос.