Быстрый старт

API datool.ru отдаёт данные MAX, которые вы видите на сайте: каталог каналов, карточки, статистику по дням и посты.

Получите ключ

1. Войдите на hi.datool.ru и откройте «API-ключи».
2. Нажмите «Создать ключ» и скопируйте его — полный ключ показывается один раз.

Сделайте первый запрос

# кто я: организация, тариф API и остаток запросов (бесплатно)
curl https://api.datool.ru/v1/me/ \
  -H "Authorization: Bearer dtk_ваш_ключ"

То же на Python:

# библиотека для HTTP-запросов: pip install requests
import requests

# ключ API из кабинета — замените на свой
HEADERS = {"Authorization": "Bearer dtk_ваш_ключ"}

# кто я: организация, тариф API и остаток запросов (бесплатно)
me = requests.get("https://api.datool.ru/v1/me/", headers=HEADERS, timeout=30).json()
print(me["api_tariff"], me["remaining_period"])

Ответ покажет вашу организацию, тариф API и сколько запросов осталось. Этот запрос бесплатный.

Найдите канал

# найти канал по ссылке max.ru/… — в ответе карточка и номер datool.ru (поле id)
curl "https://api.datool.ru/v1/max/channels/resolve/?q=https://max.ru/citynews" \
  -H "Authorization: Bearer dtk_ваш_ключ"

В ответе — карточка канала и его номер в datool.ru (id). По номеру дальше запрашивают статистику и посты.

Возьмите статистику

import requests

HEADERS = {"Authorization": "Bearer dtk_ваш_ключ"}
API = "https://api.datool.ru/v1"

# 1. номер канала по ссылке
channel = requests.get(
    f"{API}/max/channels/resolve/",
    params={"q": "https://max.ru/citynews"},
    headers=HEADERS,
    timeout=30,
).json()

# 2. статистика по дням — по умолчанию последние 30 дней
stats = requests.get(
    f"{API}/max/stats/daily/",
    params={"channels": channel["id"]},
    headers=HEADERS,
    timeout=30,
).json()

for row in stats["results"]:
    # день, подписчики на конец дня, просмотры постов этого дня
    print(row["day"], row["subscribers"], row["views"])

Что дальше

• Ключи и авторизация, Лимиты и расход, Пагинация, Фильтрация и сортировка, Форматы данных, Ошибки.
• Справочник методов — все методы с параметрами, полями ответа, примерами и ошибками.