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

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

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

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

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

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

То же на Python:

```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 и сколько запросов осталось. Этот запрос бесплатный.

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

```bash
# найти канал по ссылке 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`). По номеру дальше запрашивают статистику и посты.

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

```python
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"])
```

## Что дальше

- [Ключи и авторизация](/api/keys/), [Лимиты и расход](/api/limits/), [Пагинация](/api/pagination/), [Фильтрация и сортировка](/api/filters/), [Форматы данных](/api/formats/), [Ошибки](/api/errors/).
- [Справочник методов](/api/methods/) — все методы с параметрами, полями ответа, примерами и ошибками.

!!! note
    Бесплатный тариф «API.Max Тест» даёт 1 000 запросов за 30 дней: карточки каналов и статистику за последние 30 дней. Посты и вся история — с тарифа «API.Max Старт».