Получайте данные о каналах Max Мессенджер в своих приложениях, дашбордах и автоматизированных системах.
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" }
| Код | Описание |
|---|---|
| 200 | Успешный запрос |
| 400 | Неверный запрос (отсутствует обязательный параметр) |
| 401 | Отсутствует или недействителен API-ключ |
| 404 | Канал не найден |
| 500 | Внутренняя ошибка сервера |
/api/maxframe/channels/
Возвращает список каналов с основными данными. Пагинация по 100 каналов на страницу.
| Параметр | Тип | Обязателен | Описание |
|---|---|---|---|
api_key |
string | да* | Ключ доступа (* или в заголовке) |
page |
integer | нет | Номер страницы (по умолчанию 1) |
| Поле | Тип | Описание |
|---|---|---|
max_channel_id | integer | Уникальный ID канала |
title | string | Название канала |
description | string | Описание канала |
avatar | string | URL аватарки |
link | string | Ссылка на канал (https://max.ru/...) |
updated_at | datetime | Дата последнего обновления данных |
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
}
}
/api/maxframe/channel/by-id/<channel_id>/
Возвращает полную карточку канала по его max_channel_id.
| Параметр | Тип | Описание |
|---|---|---|
channel_id |
integer | max_channel_id канала |
| Поле | Тип | Описание |
|---|---|---|
max_channel_id | integer | Уникальный ID канала |
title | string | Название канала |
description | string | Описание канала |
avatar | string | URL аватарки |
link | string | Ссылка на канал (https://max.ru/...) |
category | string | Основная категория канала |
category2 | string | Дополнительная категория |
followers_cnt_today | integer | Количество подписчиков на сегодня |
followers_history | object | История подписчиков за последние 10 дней {дата: кол-во} |
is_a_plus_flag | integer | Верифицированный канал (1 — да, 0 — нет) |
views_24h | integer | Просмотры за последние 24 часа |
views_48h | integer | Просмотры за последние 48 часов |
er_24h | integer | Engagement Rate за 24 часа (%) |
er_48h | integer | Engagement Rate за 48 часов (%) |
updated_at | datetime | Дата последнего обновления данных |
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"
}
}
/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_id | integer | Уникальный ID канала |
title | string | Название канала |
description | string | Описание канала |
avatar | string | URL аватарки |
link | string | Ссылка на канал (https://max.ru/...) |
category | string | Основная категория канала |
category2 | string | Дополнительная категория |
followers_cnt_today | integer | Количество подписчиков на сегодня |
followers_history | object | История подписчиков за последние 10 дней {дата: кол-во} |
is_a_plus_flag | integer | Верифицированный канал (1 — да, 0 — нет) |
views_24h | integer | Просмотры за последние 24 часа |
views_48h | integer | Просмотры за последние 48 часов |
er_24h | integer | Engagement Rate за 24 часа (%) |
er_48h | integer | Engagement Rate за 48 часов (%) |
updated_at | datetime | Дата последнего обновления данных |
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"
}
}
Ключи выдаются в ручном режиме через поддержку сервиса. Напишите нам — расскажите о своём проекте, и мы выдадим ключ в ближайшее время.
Написать в поддержку — @maxframe_info