Limits and usage
What a request costs
Every request costs 1 unit, however many rows it returns: a page of 100 posts or statistics for 100 channels is also 1. Free (0 units): /v1/me/, the category and territory directories, webhook management. The cost of each method is on its page in the reference.
Limit per period
The limit is counted per 30-day period from the plan payment: paid on Oct 18 — the period runs to Nov 17, then the next one starts. Unused requests do not carry over.
| Plan | Requests per period | Per second | Keys |
|---|---|---|---|
| API.Max Test | 1,000 | 1 | 1 |
| API.Max Start | 100,000 | 5 | 2 |
| API.Max Growth | 300,000 | 10 | 5 |
| API.Max Profi | 1,500,000 | 20 | 20 |
The “Business” (MAX) subscription includes 10,000 requests per period, 5 per second and 2 keys; methods are open as on “API.Max Start”.
Response headers
X-Quota-Limit,X-Quota-Remaining— the period limit and what is left;X-Quota-Reset— when the next period starts (UTC time,…Z);X-RateLimit-Limit,X-RateLimit-Remaining— the per-second rate.
When the limit runs out
The API responds with code 429. You can buy a pack: 100,000 requests for 30 days, used only after the plan limit. Packs are on the “API keys” page in your account.
Note
Requests without a key or with a wrong key (401), rejected by a limit (429) and failed on our side (500, timeout 503) don’t count toward the limit. Other responses, including 400, 403 and 404, cost as a regular request.