# API.Max for developers and documentation at docs.datool.ru > datool.ru now offers API.Max: MAX channels, daily statistics and posts as JSON with a key. A free Test plan, webhooks for new posts and full documentation at docs.datool.ru in Russian and English with examples. News · 2026-10-31 · Евгений Химич · https://hi.datool.ru/en/news/api-and-docs/ datool.ru offers **API.Max** — programmatic access to the same MAX channel data a subscriber sees on the website: the channel catalog and cards, daily statistics and posts. Requests go to `https://api.datool.ru/v1/`, responses come back as JSON, and you authenticate with a key from your account. You can try it for free: the "API.Max Test" plan does not require a subscription. Alongside the API, the documentation site [docs.datool.ru](https://docs.datool.ru/en/) is live in Russian and English. It contains a quick start, a reference for every method with parameters, response fields and code samples, plus detailed articles with screenshots on how to use the website itself. The API is meant for anyone building their own service, reports, bot or in-house analytics on MAX data who does not want to copy numbers by hand. ## What API.Max can do The API methods mirror what the website shows a subscriber — and nothing beyond that: - **Channel catalog.** Filters by category, territory, subscriber count, the A+ mark and verified owner; search by title and handle; sorting by subscribers, quality index, citation index and the date of the latest post. With the `ids` parameter you get up to 100 cards by ID in a single request. - **Channel card.** Title, description, avatar, subscribers, categories and territory, tags, quality index and citation index, and a link to the channel page on datool.ru. - **Resolve a channel from a link.** Given a `max.ru/…` link, a @handle or a MAX ID, the method returns the channel's datool.ru ID, which you then use to request statistics and posts. - **Daily statistics.** Subscribers, posts, views, reactions and ad posts — **up to 100 channels per request**, for a period of up to 366 days. - **Posts.** A channel feed in pages of 100, newest first, and a single post by ID: text, views, reactions, the ad flag, the repost source and attachment previews. - **Directories.** Categories and territories with Russian and English names — free of charge. Dates and times in responses use Moscow time, just like the website. Error messages and labels are in Russian by default and in English with the `Accept-Language: en` header. ## Keys and access You create a key in your account at hi.datool.ru, in the "API keys" section: click "Create key", and the full key is shown only once. Keys start with `dtk_` and are passed in the `Authorization: Bearer dtk_…` header. - **A key belongs to an organization.** The request limit is shared: keys of all members draw on it. If a member is deactivated, their keys for that organization are revoked. - **Key permissions.** By default a key can only read data. Managing webhooks requires a key marked "read and write", which is set when the key is created. - **Money and access stay out of the API.** You cannot top up the balance, buy a plan or issue a new key through the API: a stolen key must not be able to spend the organization's money. ## API.Max plans Plans are listed on the [API](https://max.datool.ru/en/api/) page; the limit is counted per 30 days from the date of payment: - **API.Max Test** — 0 ₽: 1,000 requests, 1 request per second, 1 key; channel cards and statistics for the last 30 days, no posts. - **API.Max Start** — 2,990 ₽ per month: 100,000 requests, 5 per second, 2 keys; cards, full statistics and posts. - **API.Max Growth** — 9,990 ₽ per month: 300,000 requests, 10 per second, 5 keys, plus new post notifications. - **API.Max Profi** — 29,990 ₽ per month: 1.5 million requests, 20 per second, 20 keys, plus the right to show the data to your clients. - **API.Max Corporate** — by contract: from 5 million requests and a database export. Paying for 3, 6 or 12 months gives a 10, 20 or 30 % discount. The MAX analytics "Business" subscription already includes 10,000 API requests per month with Start-level access. If the limit runs out, the API responds with code 429, and you can buy a pack of 100,000 requests for 990 ₽ valid for 30 days. ![API.Max plans on the datool.ru showcase: Test, Start, Growth, Profi and Corporate](https://media.datool.ru/blog/images/2026/10/705874ead0d34dc899a51e383e6e1cdc.webp) Each request costs 1 unit, and a batch statistics request for 100 channels also costs 1. Directories and the "who am I" method (`/v1/me/`) are free. Requests that failed through our fault (server errors, database unavailable) do not count against the limit. ## Webhooks: new posts arrive on their own From the "API.Max Growth" plan onward, you no longer need to poll channel feeds every few minutes. You subscribe your MAX channels to a webhook, and we send a POST request to your server for every new post, usually within 1–2 minutes after we read it. - Growth includes 1 webhook for up to 500 channels; Profi includes up to 5 webhooks with 5,000 channels each. - Every delivery is signed with a secret (HMAC), so your server can verify that the request came from datool.ru. - If your server is unavailable, delivery is retried for up to a day. Details are in the ["Webhooks"](https://docs.datool.ru/en/api/webhooks/) article. ## Documentation at docs.datool.ru The [documentation](https://docs.datool.ru/en/) has two parts: how to use the website and how to work with the API. Both are available in Russian and English. - **API articles.** [Quick start](https://docs.datool.ru/en/api/start/), keys and authorization, [limits and usage](https://docs.datool.ru/en/api/limits/), pagination, filtering and sorting, data formats, errors, webhooks, MCP and the "API changes" log. - **Method reference.** Each method lists its address, its cost in units, what is available on the Test plan, parameters, documented response fields, request examples in Python and curl, a sample response and possible errors. - **Website guide.** Articles on every tab of the channel page, "My MAX", the account area and plans — with screenshots. - **Convenience.** Search across articles, an on-page table of contents and an "Open in Markdown" button, so you can hand a whole article to an AI assistant. ## What the API does not return The API follows the same rules as the website. We do not collect private conversations, group chat messages or comments, so they are not in the API either: a chat only has a card and counters. Posts from private channels are not returned — only the card. A post deleted in MAX is erased from our database and is not returned by the API. ## How to try it 1. Sign in or register at hi.datool.ru. 2. Open "API keys" and click "Create key". Save the key — it is shown only once. 3. Make a free `/v1/me/` request: the response shows your organization, plan and remaining requests. 4. Find the channel you need with the resolve method and request its daily statistics — examples are in the [quick start](https://docs.datool.ru/en/api/start/). ## Frequently asked questions ### Do I need a subscription to try the API? No. The "API.Max Test" plan is free and available without a subscription: 1,000 requests per 30 days, channel cards and statistics for the last 30 days. Posts and the full history become available from the "API.Max Start" plan. ### Can I search posts by text through the API? Not yet. Full-text post search in the API is marked "coming soon" on the plans page and will cost 5 units per request. ### What happens if I run out of requests before the period ends? The API responds with code 429 and tells you when the limit resets. You can wait for the next 30-day period or buy a pack of 100,000 requests for 990 ₽. Packs are not sold on the Test plan. ### Can I show datool.ru data to my clients? Yes, the "API.Max Profi" plan and higher grant that right. On Start and Growth, the data is intended for your own services and analytics. ## Summary API.Max opens MAX channel data to your systems, and bilingual documentation helps you get started in minutes. Plans and terms are on the [API](https://max.datool.ru/en/api/) page, and every method is described at [docs.datool.ru](https://docs.datool.ru/en/api/). To learn what else the service can do, read the [datool.ru launch news](https://hi.datool.ru/en/news/datool-launch/).