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

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

Вместе с API заработала документация 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, лимит считается за 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 дней.

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

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

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

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

Подробности — в статье «Вебхуки».

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

Документация разделена на две части: как пользоваться сайтом и как работать с API. Обе — на русском и английском языках.

• Статьи об API. Быстрый старт, ключи и авторизация, лимиты и расход, пагинация, фильтрация и сортировка, форматы данных, ошибки, вебхуки, MCP и журнал «Изменения API».
• Справочник методов. У каждого метода — адрес, цена в единицах, что открыто на «Тесте», параметры, поля ответа с описаниями, примеры запроса на Python и curl, пример ответа и возможные ошибки.
• Руководство по сайту. Статьи о каждой вкладке страницы канала, «Моё в MAX», кабинете и тарифах — со скриншотами.
• Удобство. Поиск по статьям, оглавление страницы, кнопка «Открыть в Markdown» — текст статьи можно отдать ИИ-ассистенту целиком.

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

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

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

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

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

Итог

API.Max открывает данные о каналах MAX для ваших систем, а документация на двух языках помогает начать за несколько минут. Тарифы и условия — на странице API, описание всех методов — на docs.datool.ru. О том, что ещё умеет сервис, читайте в новости о запуске datool.ru.