Посты

Методы группы «MAX: посты». Справа — пример запроса и ответа для каждого.

Посты канала

GET/v1/max/channels/{channel}/posts/

1 единицас тарифа «API.Max Старт»: «Тесту» посты закрыты

Посты открытого канала, новые сверху, страницами до 100 (по умолчанию 50); ссылка на следующую страницу — в поле next. Фильтры: from и to — период по московскому времени включительно, is_ad — только рекламные (true) или без рекламы (false). Открыто с тарифа «API.Max Старт»; у закрытого канала — 403 closed_channel, у группового чата — 404 (сообщения чатов мы не собираем), у удалённого или недоступного в MAX канала — 404.

Параметры

Имя параметра	Где	Описание
`channel` обязателен строка	путь	Номер канала в datool.ru или публичное имя (с @ или без)
`cursor` строка	запрос	Курсор следующей страницы — берите готовую ссылку из поля next
`from` дата	запрос	С этого дня (по Москве)
`is_ad` да / нет	запрос	Только рекламные (true) или без рекламы (false)
`limit` число	запрос	Строк на странице: 1–100, по умолчанию 50
`to` дата	запрос	По этот день включительно (по Москве)

Поля ответа

Поле	Тип	Описание
`results`	список	Посты этой страницы, новые сверху
`results[].id`	число	Номер поста в datool.ru — по нему /v1/max/posts/{id}/
`results[].channel`	число	Номер канала в datool.ru
`results[].external_id`	число	Номер поста в канале MAX
`results[].url`	строка или null	Ссылка на пост в MAX или null
`results[].published_at`	дата и время	Время публикации (ISO 8601, по Москве, +03:00)
`results[].edited_at`	дата и время или null	Когда заметили правку текста (ISO 8601, по Москве) или null
`results[].text`	строка	Текст поста без разметки (может быть пустым — пост из одних вложений)
`results[].views`	число или null	Просмотры на момент последнего чтения или null
`results[].reactions_count`	число или null	Реакций всего или null (ещё не прочитаны)
`results[].reactions`	объект	Реакции по эмодзи: {"👍": 12}
`results[].is_ad`	да / нет	Рекламный пост: есть маркировка erid, пометка «Реклама» или ссылка наружу с призывом купить или перейти (отмечается автоматически)
`results[].forwarded_from`	объект или null	Источник репоста или null
`results[].media`	список	Вложения в порядке поста
`results[].page_url`	строка	Страница поста на max.datool.ru
`next`	строка или null	Адрес следующей страницы или null

Ошибки

Код	code	Когда
400	ошибки полей	Неверный параметр или поле тела: ошибка приходит у имени поля, например {"channels": ["Номера каналов через запятую."]}.
401	`not_authenticated / authentication_failed`	Нет ключа, ключ неверный или отозван, участник приостановлен или организация ключа в архиве.
403	`tariff_required`	Посты закрыты на тарифе «API.Max Тест» — нужен «API.Max Старт».
403	`closed_channel`	Канал закрытый: через API у него только карточка.
404	`not_found`	Нет объекта с таким номером или именем, или он вам не виден.
404	`not_found`	Групповой чат: сообщения чатов не собираются.
429	`rate_limited / quota_exceeded / throttled`	Слишком часто (больше запросов в секунду, чем по тарифу) или запросы за период закончились; сколько ждать — в заголовке Retry-After.
503	`timeout`	Запрос к базе не уложился в 5 секунд — повторите позже или сузьте выборку.

Посты канала

Пример запроса:

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

# адрес метода
URL = "https://api.datool.ru/v1/max/channels/@citynews/posts/"
# ключ API из кабинета hi.datool.ru — замените на свой
HEADERS = {"Authorization": "Bearer dtk_…"}

# выполнить запрос
response = requests.get(URL, headers=HEADERS, timeout=30)
# ответ — JSON
print(response.status_code, response.json())

# ключ API из кабинета hi.datool.ru — замените на свой
curl "https://api.datool.ru/v1/max/channels/@citynews/posts/" \
  -H "Authorization: Bearer dtk_…"

Ответ 200:

{
  "results": [
    {
      "id": 9876543,
      "channel": 4821,
      "external_id": 3184,
      "url": "https://max.ru/citynews/3184",
      "published_at": "2026-10-18T11:42:00+03:00",
      "edited_at": null,
      "text": "Мэрия открыла новый парк на набережной. Рассказываем, что там есть и как добраться.",
      "views": 18450,
      "reactions_count": 236,
      "reactions": {
        "👍": 180,
        "🔥": 56
      },
      "is_ad": false,
      "forwarded_from": {
        "title": "Мэрия города",
        "link": "https://max.ru/cityhall",
        "channel": 1290
      },
      "media": [
        {
          "kind": "image",
          "position": 0,
          "width": 1280,
          "height": 720,
          "duration": null,
          "preview": "https://media.datool.ru/max/preview/2026/10/5b0e7c19.webp"
        }
      ],
      "page_url": "https://max.datool.ru/channels/citynews/posts/3184/"
    }
  ],
  "next": "https://api.datool.ru/v1/max/channels/4821/posts/?cursor=eyJvIjoiLXB1Ymxpc2hlZF9hdCIsInYiOiIyMDI2LTEwLTE4VDExOjQyOjAwKzAzOjAwIiwiaWQiOjk4NzY1NDN9"
}

Пост

GET/v1/max/posts/{id}/