# API.Max для разработчиков и документация docs.datool.ru

> На datool.ru работает API.Max: каналы MAX, статистика по дням и посты в JSON по ключу. Бесплатный тариф «Тест», вебхуки о новых постах и документация docs.datool.ru на русском и английском с примерами.

Новости · 2026-10-31 · Евгений Химич · https://hi.datool.ru/news/api-and-docs/

У datool.ru есть **API.Max** — программный доступ к тем же данным о каналах MAX, которые подписчик видит на сайте: каталог и карточки каналов, статистика по дням и посты. Запросы идут на `https://api.datool.ru/v1/`, ответы приходят в JSON, вход — по ключу из кабинета. Попробовать можно бесплатно: тариф «API.Max Тест» не требует подписки.

Вместе с API заработала документация [docs.datool.ru](https://docs.datool.ru/) — на русском и английском. В ней быстрый старт, справочник всех методов с параметрами, полями ответа и примерами кода, а также подробные статьи о работе самого сайта со скриншотами. API нужен тем, кто строит на данных MAX свой сервис, отчёты, бота или внутреннюю аналитику и не хочет переносить цифры вручную.

## Что умеет API.Max

Методы API повторяют то, что сайт показывает подписчику, — и ничего сверх этого:

- **Каталог каналов.** Фильтры по рубрике, территории, числу подписчиков, метке A+ и подтверждённому владельцу, поиск по названию и имени, сортировка по подписчикам, индексу качества, индексу цитируемости и дате последнего поста. С параметром `ids` — до 100 карточек по номерам за один запрос.
- **Карточка канала.** Название, описание, аватар, подписчики, рубрики и территория, теги, индекс качества и индекс цитируемости, ссылка на страницу канала на datool.ru.
- **Поиск канала по ссылке.** По ссылке `max.ru/…`, @имени или ID в MAX метод возвращает номер канала в datool.ru — дальше по нему запрашивают статистику и посты.
- **Статистика по дням.** Подписчики, посты, просмотры, реакции и рекламные посты — **до 100 каналов за один запрос**, период до 366 дней.
- **Посты.** Лента канала страницами по 100, новые сверху, и один пост по номеру: текст, просмотры, реакции, отметка рекламы, источник репоста, превью вложений.
- **Справочники.** Рубрики и территории с русскими и английскими названиями — бесплатно.

Даты и время в ответах — по Москве, как на сайте. Тексты ошибок и подписи — по-русски, а с заголовком `Accept-Language: en` — по-английски.

## Ключи и доступ

Ключ выпускается в кабинете hi.datool.ru, в разделе «API-ключи»: кнопка «Создать ключ», полный ключ показывается один раз. Ключ начинается с `dtk_` и передаётся в заголовке `Authorization: Bearer dtk_…`.

- **Ключ принадлежит организации.** Лимит запросов общий: его расходуют ключи всех участников. Если участника отключили, его ключи этой организации отзываются.
- **Права ключа.** По умолчанию ключ только читает данные. Для управления вебхуками нужен ключ с отметкой «чтение и запись» — её ставят при создании.
- **Деньги и доступ — не через API.** Пополнить баланс, купить тариф или выпустить новый ключ через API нельзя: украденный ключ не должен тратить деньги организации.

## Тарифы API.Max

Тарифы описаны на странице [API](https://max.datool.ru/api/), лимит считается за 30 дней с момента оплаты:

- **API.Max Тест** — 0 ₽: 1 000 запросов, 1 запрос в секунду, 1 ключ; карточки каналов и статистика за последние 30 дней, без постов.
- **API.Max Старт** — 2 990 ₽ в месяц: 100 000 запросов, 5 в секунду, 2 ключа; карточки, вся статистика и посты.
- **API.Max Рост** — 9 990 ₽ в месяц: 300 000 запросов, 10 в секунду, 5 ключей и уведомления о новых постах.
- **API.Max Профи** — 29 990 ₽ в месяц: 1,5 млн запросов, 20 в секунду, 20 ключей и право показывать данные своим клиентам.
- **API.Max Корпоративный** — по договору: от 5 млн запросов и выгрузка базы.

При оплате на 3, 6 и 12 месяцев — скидка 10, 20 и 30 %. В подписку «Бизнес» аналитики MAX уже входит 10 000 запросов API в месяц с доступом уровня «Старт». Если лимит закончился, API отвечает кодом 429, и можно докупить пакет 100 000 запросов за 990 ₽ на 30 дней.

![Тарифы API.Max на витрине datool.ru: «Тест», «Старт», «Рост», «Профи» и «Корпоративный»](https://media.datool.ru/blog/images/2026/10/ee7506636e5246fa9da113c48486d35a.webp)

Каждый запрос стоит 1 единицу, а пакетный запрос статистики по 100 каналам — тоже 1. Справочники и метод «кто я» (`/v1/me/`) бесплатны. Запросы, которые не выполнились по нашей вине (ошибки сервера, недоступная база), лимит не тратят.

## Вебхуки: новые посты приходят сами

С тарифа «API.Max Рост» не нужно каждые несколько минут опрашивать ленты каналов. Вы подписываете свои каналы MAX на вебхук — и мы сами присылаем POST-запрос на ваш сервер о каждом новом посте, обычно через 1–2 минуты после того, как прочитали его.

- На «Росте» — 1 вебхук до 500 каналов, на «Профи» — до 5 вебхуков по 5 000 каналов.
- Каждая доставка подписана секретом (HMAC), чтобы ваш сервер мог проверить, что запрос пришёл от datool.ru.
- Если ваш сервер недоступен, доставка повторяется в течение суток.

Подробности — в статье [«Вебхуки»](https://docs.datool.ru/api/webhooks/).

## Документация на docs.datool.ru

[Документация](https://docs.datool.ru/) разделена на две части: как пользоваться сайтом и как работать с API. Обе — на русском и английском языках.

- **Статьи об API.** [Быстрый старт](https://docs.datool.ru/api/start/), ключи и авторизация, [лимиты и расход](https://docs.datool.ru/api/limits/), пагинация, фильтрация и сортировка, форматы данных, ошибки, вебхуки, MCP и журнал «Изменения API».
- **Справочник методов.** У каждого метода — адрес, цена в единицах, что открыто на «Тесте», параметры, поля ответа с описаниями, примеры запроса на Python и curl, пример ответа и возможные ошибки.
- **Руководство по сайту.** Статьи о каждой вкладке страницы канала, «Моё в MAX», кабинете и тарифах — со скриншотами.
- **Удобство.** Поиск по статьям, оглавление страницы, кнопка «Открыть в Markdown» — текст статьи можно отдать ИИ-ассистенту целиком.

## Что API не отдаёт

API подчиняется тем же правилам, что и сайт. Мы не собираем личные переписки, сообщения групповых чатов и комментарии, поэтому их нет и в API: у чата есть только карточка и счётчики. Посты закрытых каналов в API не выдаются — только карточка. Пост, удалённый в MAX, стирается из нашей базы и в API тоже не возвращается.

## Как попробовать

1. Войдите или зарегистрируйтесь на hi.datool.ru.
2. Откройте «API-ключи» и нажмите «Создать ключ». Сохраните ключ — он показывается один раз.
3. Сделайте бесплатный запрос `/v1/me/`: в ответе — организация, тариф и остаток запросов.
4. Найдите нужный канал методом поиска по ссылке и запросите статистику по дням — примеры есть в [быстром старте](https://docs.datool.ru/api/start/).

## Частые вопросы

### Нужна ли подписка, чтобы попробовать API?

Нет. Тариф «API.Max Тест» бесплатный и выдаётся без подписки: 1 000 запросов за 30 дней, карточки каналов и статистика за последние 30 дней. Посты и вся история открываются с тарифа «API.Max Старт».

### Можно ли искать посты по тексту через API?

Пока нет. Поиск по текстам публикаций в API отмечен на странице тарифов как «скоро» и будет стоить 5 единиц за запрос.

### Что будет, если запросы закончатся раньше срока?

API ответит кодом 429 и подскажет, когда обновится лимит. Можно подождать начала нового 30-дневного периода или докупить пакет 100 000 запросов за 990 ₽. На тарифе «Тест» пакеты не продаются.

### Можно ли показывать данные datool.ru своим клиентам?

Да, такое право даёт тариф «API.Max Профи» и выше. На «Старте» и «Росте» данные предназначены для ваших собственных сервисов и аналитики.

## Итог

API.Max открывает данные о каналах MAX для ваших систем, а документация на двух языках помогает начать за несколько минут. Тарифы и условия — на странице [API](https://max.datool.ru/api/), описание всех методов — на [docs.datool.ru](https://docs.datool.ru/api/). О том, что ещё умеет сервис, читайте в [новости о запуске datool.ru](https://hi.datool.ru/news/datool-launch/).