API каталога MAX

Подключение

Базовый URL:

https://max.htmlweb.ru/api/{метод}

Ключ доступа — 32 символа из кабинета. Нужна подтверждённая почта.

Передайте ключ одним из способов:

GET  ...?api_key=ВАШ_КЛЮЧ&…
Header: Authorization: Bearer ВАШ_КЛЮЧ

Лимиты: 20 запросов в сутки бесплатно; дальше — с баланса (≈0.59 ₽ за запрос или пакеты). item, stat, item_update — по 1 запросу. me — без списания.

Формат ответа

Успех и ошибка всегда в JSON. Поле status — HTTP-код смысла (200 = ок).

{
  "status": 200,
  "error": "",
  "user": 12345,
  ...
}

При ошибке обычно есть непустой error с текстом на русском.

me без списания

Кто вы по ключу, какие MAX-аккаунты привязаны, сколько запросов и денег осталось.

Запрос

GET https://max.htmlweb.ru/api/me?api_key=ВАШ_КЛЮЧ

Пример ответа

{
  "status": 200,
  "error": "",
  "user": 42,
  "mail_ok": 1,
  "max_ids": [16331206, 39494245],
  "balans": 150.5,
  "limit_counter": 18,
  "free_per_day": 20,
  "per_request": 0.59,
  "docs": "https://max.htmlweb.ru/api-docs.php",
  "example": "https://max.htmlweb.ru/api/item?api_key=…&id=182789882"
}

item −1 запрос

Карточка бота, канала или чата из каталога — как на сайте, в машиночитаемом виде.

Запрос (нужен id или key)

GET https://max.htmlweb.ru/api/item?api_key=ВАШ_КЛЮЧ&id=182789882

GET https://max.htmlweb.ru/api/item?api_key=ВАШ_КЛЮЧ&key=p182789882

Пример ответа

{
  "status": 200,
  "error": "",
  "item": {
    "id": 182789882,
    "type": "bot",
    "name": "Розыгрыш призов - GiftBot",
    "username": "id616301431999_3_bot",
    "link": "https://max.ru/id616301431999_3_bot",
    "description": "Бот для розыгрышей…",
    "members": 0,
    "installs": 12500,
    "rating": 12840,
    "categories": [
      { "slug": "bots", "name": "Боты" },
      { "slug": "polls-giveaways", "name": "Опросы и розыгрыши" }
    ],
    "url": "https://max.htmlweb.ru/chat/p182789882"
  }
}

stat −1 запрос

Посуточная статистика карточки. Данные хранятся не больше 30 календарных дней — более ранние даты в ответе не появятся.

Запрос

GET https://max.htmlweb.ru/api/stat?api_key=ВАШ_КЛЮЧ&id=-69124609332678&from=2026-07-01&to=2026-07-20

Пример ответа

{
  "status": 200,
  "error": "",
  "id": -69124609332678,
  "from": "2026-07-01",
  "to": "2026-07-03",
  "days": [
    {
      "date0": "2026-07-01",
      "messages": 42,
      "posts": 12,
      "reposts": 3,
      "ad_posts": 1,
      "views": 15000,
      "likes": 80,
      "comments": 15,
      "subs_member": 25,
      "unsubs_member": 4,
      "count_member": 10200,
      "delta_member": 21,
      "votes": 5,
      "rating": 340
    }
  ]
}

Поля одного элемента days[]

Если по дню нет строки в days — за этот день в каталоге ещё не накопилась статистика (бот не стоял в чате, не было синка и т.п.).

item_update −1 запрос

Меняет описание и/или категории своей карточки. Права те же, что на сайте: владелец бота (после «Это мой бот») или администратор канала/чата. Нужна привязка MAX в кабинете.

Запрос (GET или POST)

POST https://max.htmlweb.ru/api/item_update?api_key=ВАШ_КЛЮЧ
Content-Type: application/x-www-form-urlencoded

id=182789882&description=Новое+описание+бота&categories=bots,polls-giveaways

GET https://max.htmlweb.ru/api/item_update?api_key=ВАШ_КЛЮЧ&id=182789882&description=Текст

Пример ответа — как у item: объект item уже с новыми данными.

{
  "status": 200,
  "error": "",
  "item": { "id": 182789882, "description": "Новое описание бота", "categories": [ … ], … }
}

Если нет прав или MAX не привязан — status 403 и текст в error.

Ошибки

Общие правила всех API htmlweb: общие параметры.

{
  "error": "Исчерпан лимит бесплатного количества запросов в сутки…"
}