REST API

MaxFrame API

Получайте данные о каналах Max Мессенджер в своих приложениях, дашбордах и автоматизированных системах.

На данном этапе API-ключи выдаются в ручном режиме через поддержку сервиса. Напишите нам в @maxframe_info — ответим и выдадим ключ в ближайшее время.

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

Базовый URL
https://maxframe.ru/api/maxframe/
Аутентификация

Передайте ключ в HTTP-заголовке или как GET-параметр:

# заголовок (рекомендуется)
X-Api-Key: ваш_ключ
_
# либо GET-параметр
?api_key=ваш_ключ
Формат ответа

Все ответы — JSON. При успехе "success": true, при ошибке — "success": false с полем "error".

# успех
{ "success": true, "data": { ... } }
_
# ошибка
{ "success": false, "error": "Invalid or missing API key" }

HTTP-коды ответов

Код Описание
200Успешный запрос
400Неверный запрос (отсутствует обязательный параметр)
401Отсутствует или недействителен API-ключ
404Канал не найден
500Внутренняя ошибка сервера

Эндпоинты

GET /api/maxframe/channels/

Список всех каналов

Возвращает список каналов с основными данными. Пагинация по 100 каналов на страницу.

Параметры запроса
ПараметрТипОбязателенОписание
api_key string да* Ключ доступа (* или в заголовке)
page integer нет Номер страницы (по умолчанию 1)
Поля ответа
ПолеТипОписание
max_channel_idintegerУникальный ID канала
titlestringНазвание канала
descriptionstringОписание канала
avatarstringURL аватарки
linkstringСсылка на канал (https://max.ru/...)
updated_atdatetimeДата последнего обновления данных
Пример запроса
curl -H "X-Api-Key: ваш_ключ" \
     "https://maxframe.ru/api/maxframe/channels/?page=1"
Пример ответа
{
  "success": true,
  "data": [
    {
      "max_channel_id": 68356104251951,
      "title": "Название канала",
      "description": "Описание канала...",
      "avatar": "https://cdn.example.com/avatar.jpg",
      "link": "https://max.ru/channel_name",
      "updated_at": "2026-06-15T10:30:00"
    }
  ],
  "pagination": {
    "page": 1,
    "per_page": 100,
    "count": 100,
    "has_next": true
  }
}
GET /api/maxframe/channel/by-id/<channel_id>/

Карточка канала по ID

Возвращает полную карточку канала по его max_channel_id.

Параметры пути
ПараметрТипОписание
channel_id integer max_channel_id канала
Поля ответа
ПолеТипОписание
max_channel_idintegerУникальный ID канала
titlestringНазвание канала
descriptionstringОписание канала
avatarstringURL аватарки
linkstringСсылка на канал (https://max.ru/...)
categorystringОсновная категория канала
category2stringДополнительная категория
followers_cnt_todayintegerКоличество подписчиков на сегодня
followers_historyobjectИстория подписчиков за последние 10 дней {дата: кол-во}
is_a_plus_flagintegerВерифицированный канал (1 — да, 0 — нет)
views_24hintegerПросмотры за последние 24 часа
views_48hintegerПросмотры за последние 48 часов
er_24hintegerEngagement Rate за 24 часа (%)
er_48hintegerEngagement Rate за 48 часов (%)
updated_atdatetimeДата последнего обновления данных
Пример запроса
curl -H "X-Api-Key: ваш_ключ" \
     "https://maxframe.ru/api/maxframe/channel/by-id/68056453581545/"
Пример ответа
{
  "success": true,
  "data": {
    "max_channel_id": 68056453581545,
    "title": "РИА Новости",
    "description": "Официальная страница сайта ria.ru",
    "avatar": "https://i.oneme.ru/i?r=BTEFHNxX...&fn=w_1440",
    "link": "https://max.ru/ria",
    "category": "Новости и СМИ",
    "category2": "Политика",
    "followers_cnt_today": 1185513,
    "followers_history": {
      "2026-06-23": 1165645,
      "2026-06-24": 1167457,
      "2026-06-25": 1169629,
      "2026-06-26": 1172087,
      "2026-06-27": 1174654,
      "2026-06-28": 1176379,
      "2026-06-29": 1178791,
      "2026-06-30": 1180870,
      "2026-07-01": 1183874,
      "2026-07-02": 1185513
    },
    "is_a_plus_flag": 1,
    "views_24h": 417519,
    "views_48h": 432715,
    "er_24h": 35,
    "er_48h": 37,
    "updated_at": "2026-07-02T15:02:40"
  }
}
GET /api/maxframe/channel/by-link/?link=<link>

Карточка канала по ссылке

Возвращает полную карточку канала по его публичной ссылке. Ссылки вида https://web.max.ru/... нормализуются автоматически.

Параметры запроса
ПараметрТипОбязателенОписание
link string да Полная ссылка на канал
api_key string да* Ключ доступа (* или в заголовке)
Нормализация ссылок
# принимается
https://web.max.ru/ASGasparyan
_
# хранится как
https://max.ru/ASGasparyan

Оба варианта ссылки работают — нормализация происходит на стороне API.

Поля ответа
ПолеТипОписание
max_channel_idintegerУникальный ID канала
titlestringНазвание канала
descriptionstringОписание канала
avatarstringURL аватарки
linkstringСсылка на канал (https://max.ru/...)
categorystringОсновная категория канала
category2stringДополнительная категория
followers_cnt_todayintegerКоличество подписчиков на сегодня
followers_historyobjectИстория подписчиков за последние 10 дней {дата: кол-во}
is_a_plus_flagintegerВерифицированный канал (1 — да, 0 — нет)
views_24hintegerПросмотры за последние 24 часа
views_48hintegerПросмотры за последние 48 часов
er_24hintegerEngagement Rate за 24 часа (%)
er_48hintegerEngagement Rate за 48 часов (%)
updated_atdatetimeДата последнего обновления данных
Пример запроса
curl -H "X-Api-Key: ваш_ключ" \
     "https://maxframe.ru/api/maxframe/channel/by-link/?link=https://max.ru/ria"
Пример ответа
{
  "success": true,
  "data": {
    "max_channel_id": 68056453581545,
    "title": "РИА Новости",
    "description": "Официальная страница сайта ria.ru",
    "avatar": "https://i.oneme.ru/i?r=BTEFHNxX...&fn=w_1440",
    "link": "https://max.ru/ria",
    "category": "Новости и СМИ",
    "category2": "Политика",
    "followers_cnt_today": 1185513,
    "followers_history": {
      "2026-06-23": 1165645,
      "2026-06-24": 1167457,
      "2026-06-25": 1169629,
      "2026-06-26": 1172087,
      "2026-06-27": 1174654,
      "2026-06-28": 1176379,
      "2026-06-29": 1178791,
      "2026-06-30": 1180870,
      "2026-07-01": 1183874,
      "2026-07-02": 1185513
    },
    "is_a_plus_flag": 1,
    "views_24h": 417519,
    "views_48h": 432715,
    "er_24h": 35,
    "er_48h": 37,
    "updated_at": "2026-07-02T15:02:40"
  }
}

Получить API-ключ

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

Написать в поддержку — @maxframe_info