Данные о каналах Max Мессенджер для ваших приложений, дашбордов и автоматизаций: метрики каналов, посты с охватами, реклама, поиск по публикациям и топы.
X-Api-Key (или параметром ?api_key=).https://maxframe.ru/api/maxframe/
curl -H "X-Api-Key: ваш_ключ" "https://maxframe.ru/api/maxframe/channel/by-link/?link=https://max.ru/ria"
# заголовок (рекомендуется) X-Api-Key: ваш_ключ # либо GET-параметр ?api_key=ваш_ключ
Все ответы — JSON. Успех: "success": true, данные в data, у списков — pagination, у всех — meta.
{
"success": true,
"data": { ... } | [ ... ],
"pagination": { "page": 1, "per_page": 100, "count": 100, "has_next": true },
"meta": {
"api_version": "1.1.1",
"data_updated_at": "2026-10-19T09:10:00Z",
"request_cost": 1,
"requests_remaining": 26199
}
}
meta.data_updated_at — когда обновлён набор данных этого метода.meta.requests_remaining — остаток запросов пакета (дублируется в заголовке X-Requests-Remaining).Z. Поле updated_at сохраняет прежний формат без часового пояса.page (с 1) и per_page (1–100, по умолчанию 100). Общего числа записей нет: есть has_next.per_page.Retry-After: 1, запрос не списывается.X-Request-Cost: 1 X-RateLimit-Limit: 2 X-Requests-Remaining: 26199 X-Balance-Expires: 2026-11-16T10:15:00+00:00
Ошибка: "success": false, текст в error и машинный код в error_code — проверяйте его в коде вместо текста.
{ "success": false, "error": "Parameter \"days\" must be one of: 10, 30, 60, 90", "error_code": "bad_request", "param": "days" }
| error_code | HTTP | Когда | Списывается |
|---|---|---|---|
invalid_api_key | 401 | Ключ не передан или не найден | нет |
balance_exhausted | 402 | Запросы кончились или срок пакета истёк (+ поле renew_url) | нет |
bad_request | 400 | Неверный параметр (+ поле param с именем параметра) | нет |
not_found | 404 | Канал не найден или его данные старше 7 дней | да |
rate_limited | 429 | Больше 2 запросов в секунду с одного ключа (+ заголовок Retry-After: 1) | нет |
server_error | 500 | Ошибка базы данных | нет |
timeout | 504 | Запрос не уложился в 5 секунд — сузьте период или фильтры | нет |
meta.data_updated_at и в методе /status/.followers_updated_at — время последнего замера подписчиков канала.is_stale = 1 — замеру больше 36 часов (например, из канала удалили бота MaxFrame). Канал отдаётся с последними известными данными.days: 10, 30, 60 или 90 (по умолчанию 30).max найдёт и max, и maxframe.реклам найдёт реклама, рекламу, рекламный.q=скидка промокод.|: q=wildberries|ozon.кот найдёт и «который»).days=10 или channel_id. Глубже 10-й страницы — сузьте период или фильтры.GET /api/maxframe/publications/search/?q=maxframe GET /api/maxframe/publications/search/?q=реклам курс&days=10 GET /api/maxframe/publications/search/?q=wildberries|ozon&category=Мода и красота&min_followers=5000
/api/maxframe/channels/
1 запрос
Все каналы MaxFrame с основными метриками. Фильтры и сортировка необязательны: без них список отдаёт все каналы, отсортированные по max_channel_id (порядок стабилен между страницами). При равенстве значений сортировки вторым ключом идёт max_channel_id.
| Параметр | Тип | Обязателен | По умолчанию | Описание |
|---|---|---|---|---|
category |
string | нет | — | Точное совпадение категории (значения — из /categories/) |
category2 |
string | нет | — | Подкатегория |
min_followers |
integer | нет | — | Не меньше подписчиков |
max_followers |
integer | нет | — | Не больше подписчиков |
exclude_fraud |
integer | нет | — | 1 — исключить каналы с пометками накрутки и мошенничества: 0, 1 |
active_days |
integer | нет | — | Только каналы с публикацией за последние N дней (1–90) |
exclude_stale |
integer | нет | — | 1 — исключить каналы с is_stale = 1: 0, 1 |
sort |
string | нет | id_asc | Сортировка: id_asc, followers_desc, followers_asc, growth_7d_desc, views_desc, last_post_desc |
page |
integer | нет | 1 | Номер страницы, с 1 |
per_page |
integer | нет | 100 | Записей на странице (1–100) |
| Поле | Тип | Описание |
|---|---|---|
max_channel_id | integer | Уникальный ID канала |
title | string | Название канала |
description | string | Описание канала |
avatar | string | URL аватарки |
link | string | Ссылка на канал |
updated_at | datetime | Время обновления данных канала (формат v1.0) |
category | string | Основная категория; пусто — канала нет в карточках API |
category2 | string | Подкатегория |
followers_cnt | integer | Подписчики по последнему замеру |
followers_change_24h | integer | Изменение подписчиков за 24 часа |
followers_change_7d | integer | Изменение подписчиков за 7 дней |
followers_change_30d | integer | Изменение подписчиков за 30 дней |
views_24h | integer | null | Охват последнего поста за 24 часа |
avg_views_7d | integer | Средний охват поста за 24 часа, по постам за 7 дней |
er_avg_7d | number | Средний ER за 7 дней, % |
last_post_at | datetime | null | Время последней публикации |
posts_7d | integer | Публикаций за 7 дней |
is_followers_fraud | integer 0/1 | Признаки накрутки подписчиков |
is_owner_fraud | integer 0/1 | Владелец замечен в мошенничестве |
is_official | integer 0/1 | Официальный канал |
is_a_plus_flag | integer 0/1 | Канал с отметкой A+ |
followers_updated_at | datetime | null | Время последнего замера подписчиков |
is_stale | integer 0/1 | 1 — данным больше 36 часов или канала нет в карточках API |
maxframe_url | string | Страница канала на maxframe.ru |
curl -G "https://maxframe.ru/api/maxframe/channels/" \
-H "X-Api-Key: ваш_ключ" \
--data-urlencode "category=Новости и СМИ" \
--data-urlencode "min_followers=10000" \
--data-urlencode "exclude_fraud=1" \
--data-urlencode "sort=growth_7d_desc" \
--data-urlencode "per_page=50"
import requests
r = requests.get(
"https://maxframe.ru/api/maxframe/channels/",
params={"category": "Новости и СМИ", "min_followers": "10000", "exclude_fraud": "1", "sort": "growth_7d_desc", "per_page": "50"},
headers={"X-Api-Key": "ваш_ключ"},
timeout=10,
)
print(r.json())
const url = new URL("https://maxframe.ru/api/maxframe/channels/");
Object.entries({"category": "Новости и СМИ", "min_followers": "10000", "exclude_fraud": "1", "sort": "growth_7d_desc", "per_page": "50"}).forEach(([k, v]) => url.searchParams.set(k, v));
const r = await fetch(url, { headers: { "X-Api-Key": "ваш_ключ" } });
console.log(await r.json());
{
"success": true,
"data": [
{
"max_channel_id": 71253668593887,
"title": "Россия 365. Новости",
"description": "Главный новостной канал в MAX…",
"avatar": "https://maxframe.ru/img/oneme/i?r=B1PLc4bX6k8W…&fn=w_1440",
"link": "https://max.ru/join/ORmuh2oA7qtuqkC3Vik0",
"updated_at": "2026-10-19T12:40:58",
"category": "Политика",
"category2": "Новости и СМИ",
"followers_cnt": 1301268,
"followers_change_24h": 5464,
"followers_change_7d": 42210,
"followers_change_30d": 78684,
"views_24h": 309557,
"avg_views_7d": 259801,
"er_avg_7d": 20.0,
"last_post_at": "2026-10-19T09:12:00Z",
"posts_7d": 71,
"is_followers_fraud": 0,
"is_owner_fraud": 0,
"is_official": 0,
"is_a_plus_flag": 1,
"followers_updated_at": "2026-10-19T09:40:59Z",
"is_stale": 0,
"maxframe_url": "https://maxframe.ru/channel-profile/71253668593887/"
}
],
"pagination": {
"page": 1,
"per_page": 50,
"count": 1,
"has_next": true
},
"meta": {
"api_version": "1.1.1",
"data_updated_at": "2026-10-19T09:10:00Z",
"request_cost": 1,
"requests_remaining": 26199
}
}
/api/maxframe/channel/by-id/<channel_id>/
1 запрос
Полная карточка канала: подписчики и их динамика, частота публикаций, охваты, реклама, пометки накрутки. Каналы без обновлений больше 7 дней не отдаются (404).
| Параметр | Тип | Обязателен | По умолчанию | Описание |
|---|---|---|---|---|
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 | Основная категория (значения — из /categories/) |
category2 | string | Подкатегория |
followers_cnt_today | integer | Подписчики по последнему замеру |
followers_history | object | Подписчики за последние 10 дней: {"ГГГГ-ММ-ДД": число} |
is_a_plus_flag | integer 0/1 | Канал с отметкой A+ (1 — да) |
views_24h | integer | Охват последнего поста за 24 часа |
views_48h | integer | Охват последнего поста за 48 часов |
er_24h | integer | ER за 24 часа, % (охват / подписчики) |
er_48h | integer | ER за 48 часов, % |
updated_at | datetime | Время обновления данных канала (формат v1.0, без часового пояса) |
followers_updated_at | datetime | Время последнего замера подписчиков |
is_stale | integer 0/1 | 1 — последнему замеру больше 36 часов (например, из канала удалили бота MaxFrame) |
followers_change_24h | integer | Изменение подписчиков за 24 часа |
followers_change_7d | integer | Изменение подписчиков за 7 дней |
followers_change_30d | integer | Изменение подписчиков за 30 дней |
last_post_at | datetime | null | Время последней публикации за 90 дней; null — публикаций не было |
posts_24h | integer | Публикаций за 24 часа |
posts_7d | integer | Публикаций за 7 дней |
posts_30d | integer | Публикаций за 30 дней |
avg_posts_per_day_30d | number | Среднее число публикаций в день за 30 дней |
avg_views_7d | integer | Средний охват поста за первые 24 часа, по постам за 7 дней |
er_avg_7d | number | avg_views_7d / подписчики × 100, не больше 100 |
ads_received_7d | integer | Сколько разных каналов рекламировали этот канал за 7 дней |
ads_received_30d | integer | Сколько разных каналов рекламировали этот канал за 30 дней |
ads_placed_30d | integer | Сколько разных каналов этот канал рекламировал у себя за 30 дней |
is_followers_fraud | integer 0/1 | Признаки накрутки подписчиков |
is_owner_fraud | integer 0/1 | Владелец замечен в мошенничестве |
fraud_reason | string | Причина пометки (пусто, если пометок нет) |
is_official | integer 0/1 | Официальный канал |
shortname | string | Короткое имя канала |
maxframe_url | string | Страница канала на maxframe.ru |
curl -G "https://maxframe.ru/api/maxframe/channel/by-id/71253668593887/" \
-H "X-Api-Key: ваш_ключ"
import requests
r = requests.get(
"https://maxframe.ru/api/maxframe/channel/by-id/71253668593887/",
headers={"X-Api-Key": "ваш_ключ"},
timeout=10,
)
print(r.json())
const url = new URL("https://maxframe.ru/api/maxframe/channel/by-id/71253668593887/");
const r = await fetch(url, { headers: { "X-Api-Key": "ваш_ключ" } });
console.log(await r.json());
{
"success": true,
"data": {
"max_channel_id": 71253668593887,
"title": "Россия 365. Новости",
"description": "Главный новостной канал в MAX…",
"avatar": "https://maxframe.ru/img/oneme/i?r=B1PLc4bX6k8W…&fn=w_1440",
"link": "https://max.ru/join/ORmuh2oA7qtuqkC3Vik0",
"category": "Политика",
"category2": "Новости и СМИ",
"followers_cnt_today": 1301268,
"followers_history": {
"2026-10-18": 1301445,
"2026-10-19": 1301268
},
"is_a_plus_flag": 1,
"views_24h": 309557,
"views_48h": 306138,
"er_24h": 24,
"er_48h": 24,
"updated_at": "2026-10-19T12:40:58",
"followers_updated_at": "2026-10-19T09:40:59Z",
"is_stale": 0,
"followers_change_24h": 5464,
"followers_change_7d": 42210,
"followers_change_30d": 78684,
"last_post_at": "2026-10-19T09:12:00Z",
"posts_24h": 10,
"posts_7d": 71,
"posts_30d": 298,
"avg_posts_per_day_30d": 9.93,
"avg_views_7d": 259801,
"er_avg_7d": 20.0,
"ads_received_7d": 291,
"ads_received_30d": 1043,
"ads_placed_30d": 106,
"is_followers_fraud": 0,
"is_owner_fraud": 0,
"fraud_reason": "",
"is_official": 0,
"shortname": "russia365",
"maxframe_url": "https://maxframe.ru/channel-profile/71253668593887/"
},
"meta": {
"api_version": "1.1.1",
"data_updated_at": "2026-10-19T09:10:00Z",
"request_cost": 1,
"requests_remaining": 26199
}
}
/api/maxframe/channel/by-link/
1 запрос
Та же карточка, поиск по публичной ссылке. Ссылки https://web.max.ru/... нормализуются автоматически.
| Параметр | Тип | Обязателен | По умолчанию | Описание |
|---|---|---|---|---|
link |
string | да | — | Полная ссылка на канал |
| Поле | Тип | Описание |
|---|---|---|
max_channel_id | integer | Уникальный ID канала |
title | string | Название канала |
description | string | Описание канала |
avatar | string | URL аватарки |
link | string | Ссылка на канал (https://max.ru/...) |
category | string | Основная категория (значения — из /categories/) |
category2 | string | Подкатегория |
followers_cnt_today | integer | Подписчики по последнему замеру |
followers_history | object | Подписчики за последние 10 дней: {"ГГГГ-ММ-ДД": число} |
is_a_plus_flag | integer 0/1 | Канал с отметкой A+ (1 — да) |
views_24h | integer | Охват последнего поста за 24 часа |
views_48h | integer | Охват последнего поста за 48 часов |
er_24h | integer | ER за 24 часа, % (охват / подписчики) |
er_48h | integer | ER за 48 часов, % |
updated_at | datetime | Время обновления данных канала (формат v1.0, без часового пояса) |
followers_updated_at | datetime | Время последнего замера подписчиков |
is_stale | integer 0/1 | 1 — последнему замеру больше 36 часов (например, из канала удалили бота MaxFrame) |
followers_change_24h | integer | Изменение подписчиков за 24 часа |
followers_change_7d | integer | Изменение подписчиков за 7 дней |
followers_change_30d | integer | Изменение подписчиков за 30 дней |
last_post_at | datetime | null | Время последней публикации за 90 дней; null — публикаций не было |
posts_24h | integer | Публикаций за 24 часа |
posts_7d | integer | Публикаций за 7 дней |
posts_30d | integer | Публикаций за 30 дней |
avg_posts_per_day_30d | number | Среднее число публикаций в день за 30 дней |
avg_views_7d | integer | Средний охват поста за первые 24 часа, по постам за 7 дней |
er_avg_7d | number | avg_views_7d / подписчики × 100, не больше 100 |
ads_received_7d | integer | Сколько разных каналов рекламировали этот канал за 7 дней |
ads_received_30d | integer | Сколько разных каналов рекламировали этот канал за 30 дней |
ads_placed_30d | integer | Сколько разных каналов этот канал рекламировал у себя за 30 дней |
is_followers_fraud | integer 0/1 | Признаки накрутки подписчиков |
is_owner_fraud | integer 0/1 | Владелец замечен в мошенничестве |
fraud_reason | string | Причина пометки (пусто, если пометок нет) |
is_official | integer 0/1 | Официальный канал |
shortname | string | Короткое имя канала |
maxframe_url | string | Страница канала на maxframe.ru |
curl -G "https://maxframe.ru/api/maxframe/channel/by-link/" \
-H "X-Api-Key: ваш_ключ" \
--data-urlencode "link=https://max.ru/ria"
import requests
r = requests.get(
"https://maxframe.ru/api/maxframe/channel/by-link/",
params={"link": "https://max.ru/ria"},
headers={"X-Api-Key": "ваш_ключ"},
timeout=10,
)
print(r.json())
const url = new URL("https://maxframe.ru/api/maxframe/channel/by-link/");
Object.entries({"link": "https://max.ru/ria"}).forEach(([k, v]) => url.searchParams.set(k, v));
const r = await fetch(url, { headers: { "X-Api-Key": "ваш_ключ" } });
console.log(await r.json());
{
"success": true,
"data": {
"max_channel_id": 71253668593887,
"title": "Россия 365. Новости",
"description": "Главный новостной канал в MAX…",
"avatar": "https://maxframe.ru/img/oneme/i?r=B1PLc4bX6k8W…&fn=w_1440",
"link": "https://max.ru/join/ORmuh2oA7qtuqkC3Vik0",
"category": "Политика",
"category2": "Новости и СМИ",
"followers_cnt_today": 1301268,
"followers_history": {
"2026-10-18": 1301445,
"2026-10-19": 1301268
},
"is_a_plus_flag": 1,
"views_24h": 309557,
"views_48h": 306138,
"er_24h": 24,
"er_48h": 24,
"updated_at": "2026-10-19T12:40:58",
"followers_updated_at": "2026-10-19T09:40:59Z",
"is_stale": 0,
"followers_change_24h": 5464,
"followers_change_7d": 42210,
"followers_change_30d": 78684,
"last_post_at": "2026-10-19T09:12:00Z",
"posts_24h": 10,
"posts_7d": 71,
"posts_30d": 298,
"avg_posts_per_day_30d": 9.93,
"avg_views_7d": 259801,
"er_avg_7d": 20.0,
"ads_received_7d": 291,
"ads_received_30d": 1043,
"ads_placed_30d": 106,
"is_followers_fraud": 0,
"is_owner_fraud": 0,
"fraud_reason": "",
"is_official": 0,
"shortname": "russia365",
"maxframe_url": "https://maxframe.ru/channel-profile/71253668593887/"
},
"meta": {
"api_version": "1.1.1",
"data_updated_at": "2026-10-19T09:10:00Z",
"request_cost": 1,
"requests_remaining": 26199
}
}
/api/maxframe/channel/<channel_id>/posts/
1 запрос
Последние публикации канала от новых к старым: текст, ссылки, упомянутые каналы, вложения и охваты. Пустой список — публикаций за период не было; 404 — канал неизвестен.
| Параметр | Тип | Обязателен | По умолчанию | Описание |
|---|---|---|---|---|
channel_id в пути |
integer | да | — | max_channel_id канала |
days |
integer | нет | 30 | Глубина данных в днях: 10, 30, 60, 90 |
type |
string | нет | all | all — все посты, direct — только собственные посты канала: all, direct |
page |
integer | нет | 1 | Номер страницы, с 1 |
per_page |
integer | нет | 100 | Записей на странице (1–100) |
| Поле | Тип | Описание |
|---|---|---|
published_at | datetime | Время публикации |
text | string | Текст поста |
post_link | string | Ссылка на пост (может быть пустой у старых постов) |
message_type | string | Тип сообщения: direct — собственный пост канала |
links | array<string> | Ссылки из поста |
mentioned_channels | array<object> | Упомянутые каналы MAX: [{max_channel_id, title, link}] |
images | array<string> | Изображения поста |
buttons | array<object> | Кнопки поста: [{text, url}] |
views_24h | integer | Охват за первые 24 часа после публикации |
views_total | integer | Максимальный известный охват |
is_ad | integer 0/1 | 1 — в посте есть ссылка на другой канал MAX (рекламное размещение) |
curl -G "https://maxframe.ru/api/maxframe/channel/68947474079904/posts/" \
-H "X-Api-Key: ваш_ключ" \
--data-urlencode "days=10" \
--data-urlencode "per_page=20"
import requests
r = requests.get(
"https://maxframe.ru/api/maxframe/channel/68947474079904/posts/",
params={"days": "10", "per_page": "20"},
headers={"X-Api-Key": "ваш_ключ"},
timeout=10,
)
print(r.json())
const url = new URL("https://maxframe.ru/api/maxframe/channel/68947474079904/posts/");
Object.entries({"days": "10", "per_page": "20"}).forEach(([k, v]) => url.searchParams.set(k, v));
const r = await fetch(url, { headers: { "X-Api-Key": "ваш_ключ" } });
console.log(await r.json());
{
"success": true,
"data": [
{
"published_at": "2026-10-18T17:56:39Z",
"text": "Подписывайтесь на «Радар России» — главные новости дня 👇",
"post_link": "https://max.ru/kerch_onlinee/AaFQKJQ2OUI",
"message_type": "direct",
"links": [
"https://max.ru/channel_radar_russia"
],
"mentioned_channels": [
{
"max_channel_id": 69464494268576,
"title": "Радар России",
"link": "https://max.ru/channel_radar_russia"
}
],
"images": [
"https://maxframe.ru/img/oneme/i?r=B0zLc4bX6k8W…"
],
"buttons": [],
"views_24h": 1353,
"views_total": 1353,
"is_ad": 1
}
],
"pagination": {
"page": 1,
"per_page": 20,
"count": 1,
"has_next": true
},
"meta": {
"api_version": "1.1.1",
"data_updated_at": "2026-10-19T09:10:00Z",
"request_cost": 1,
"requests_remaining": 26199
}
}
/api/maxframe/channel/<channel_id>/ads/received/
1 запрос
Посты других каналов MAX со ссылкой на этот канал, от новых к старым. Одна запись — один пост канала-рекламодателя. Реклама определяется по ссылкам на каналы MAX в постах; размещения из Telegram в API не входят.
| Параметр | Тип | Обязателен | По умолчанию | Описание |
|---|---|---|---|---|
channel_id в пути |
integer | да | — | max_channel_id канала |
days |
integer | нет | 30 | Глубина данных в днях: 10, 30, 60, 90 |
page |
integer | нет | 1 | Номер страницы, с 1 |
per_page |
integer | нет | 100 | Записей на странице (1–100) |
| Поле | Тип | Описание |
|---|---|---|
advertiser_channel_id | integer | Канал, в котором вышла реклама |
advertiser_title | string | Название канала |
advertiser_link | string | Ссылка на канал |
advertiser_avatar | string | URL аватарки |
advertiser_followers_cnt | integer | Подписчики канала |
published_at | datetime | Время публикации рекламного поста |
post_text | string | Текст поста |
images | array<string> | Изображения поста |
buttons | array<object> | Кнопки поста |
views_24h | integer | Охват поста за 24 часа |
views_total | integer | Максимальный известный охват поста |
advertiser_is_fraud | integer 0/1 | 1 — у канала-рекламодателя есть пометка накрутки или мошенничества |
curl -G "https://maxframe.ru/api/maxframe/channel/74017239111056/ads/received/" \
-H "X-Api-Key: ваш_ключ" \
--data-urlencode "days=30"
import requests
r = requests.get(
"https://maxframe.ru/api/maxframe/channel/74017239111056/ads/received/",
params={"days": "30"},
headers={"X-Api-Key": "ваш_ключ"},
timeout=10,
)
print(r.json())
const url = new URL("https://maxframe.ru/api/maxframe/channel/74017239111056/ads/received/");
Object.entries({"days": "30"}).forEach(([k, v]) => url.searchParams.set(k, v));
const r = await fetch(url, { headers: { "X-Api-Key": "ваш_ключ" } });
console.log(await r.json());
{
"success": true,
"data": [
{
"advertiser_channel_id": 74241621463071,
"advertiser_title": "Тихое сияние разума",
"advertiser_link": "https://max.ru/join/b35-FB9eRqcz",
"advertiser_avatar": "https://maxframe.ru/img/oneme/i?r=B1PLc4…",
"advertiser_followers_cnt": 3439,
"published_at": "2026-10-18T17:37:08Z",
"post_text": "В своём канале я рассказываю, как они мыслят на самом деле 👇",
"images": [
"https://maxframe.ru/img/oneme/i?r=B0zLc4…"
],
"buttons": [
{
"text": "Узнать правду",
"url": "https://max.ru/join/0-ObFkKfXix"
}
],
"views_24h": 208,
"views_total": 208,
"advertiser_is_fraud": 0
}
],
"pagination": {
"page": 1,
"per_page": 100,
"count": 1,
"has_next": true
},
"meta": {
"api_version": "1.1.1",
"data_updated_at": "2026-10-19T09:10:00Z",
"request_cost": 1,
"requests_remaining": 26199
}
}
/api/maxframe/channel/<channel_id>/ads/placed/
1 запрос
Посты этого канала со ссылками на другие каналы MAX, от новых к старым. Одна запись — пост + упомянутый в нём канал.
| Параметр | Тип | Обязателен | По умолчанию | Описание |
|---|---|---|---|---|
channel_id в пути |
integer | да | — | max_channel_id канала |
days |
integer | нет | 30 | Глубина данных в днях: 10, 30, 60, 90 |
page |
integer | нет | 1 | Номер страницы, с 1 |
per_page |
integer | нет | 100 | Записей на странице (1–100) |
| Поле | Тип | Описание |
|---|---|---|
advertised_channel_id | integer | Канал, который рекламировали |
advertised_title | string | Название канала |
advertised_link | string | Ссылка на канал |
advertised_avatar | string | URL аватарки |
advertised_followers_cnt | integer | Подписчики канала |
published_at | datetime | Время публикации рекламного поста |
post_text | string | Текст поста |
images | array<string> | Изображения поста |
buttons | array<object> | Кнопки поста |
views_24h | integer | Охват поста за 24 часа |
views_total | integer | Максимальный известный охват поста |
advertised_is_fraud | integer 0/1 | 1 — у рекламируемого канала есть пометка накрутки или мошенничества |
curl -G "https://maxframe.ru/api/maxframe/channel/74241621463071/ads/placed/" \
-H "X-Api-Key: ваш_ключ" \
--data-urlencode "days=30"
import requests
r = requests.get(
"https://maxframe.ru/api/maxframe/channel/74241621463071/ads/placed/",
params={"days": "30"},
headers={"X-Api-Key": "ваш_ключ"},
timeout=10,
)
print(r.json())
const url = new URL("https://maxframe.ru/api/maxframe/channel/74241621463071/ads/placed/");
Object.entries({"days": "30"}).forEach(([k, v]) => url.searchParams.set(k, v));
const r = await fetch(url, { headers: { "X-Api-Key": "ваш_ключ" } });
console.log(await r.json());
{
"success": true,
"data": [
{
"advertised_channel_id": 74017239111056,
"advertised_title": "Ирина Ельская про отношения",
"advertised_link": "https://max.ru/join/b35-FB9eRqcz",
"advertised_avatar": "https://maxframe.ru/img/oneme/i?r=B1PLc4…",
"advertised_followers_cnt": 8323,
"published_at": "2026-10-18T17:37:08Z",
"post_text": "В своём канале я рассказываю, как они мыслят на самом деле 👇",
"images": [
"https://maxframe.ru/img/oneme/i?r=B0zLc4…"
],
"buttons": [
{
"text": "Узнать правду",
"url": "https://max.ru/join/0-ObFkKfXix"
}
],
"views_24h": 208,
"views_total": 208,
"advertised_is_fraud": 0
}
],
"pagination": {
"page": 1,
"per_page": 100,
"count": 1,
"has_next": true
},
"meta": {
"api_version": "1.1.1",
"data_updated_at": "2026-10-19T09:10:00Z",
"request_cost": 1,
"requests_remaining": 26199
}
}
/api/maxframe/publications/search/
1 запрос
Поиск по началу слова: «max» найдёт max и maxframe; «реклам» — реклама, рекламу, рекламный. Регистр не важен, «ё» и «е» не различаются. Все слова запроса должны быть в посте (в любом месте); варианты одного слова — через «|». От новых к старым; общего числа совпадений нет, есть has_next.
| Параметр | Тип | Обязателен | По умолчанию | Описание |
|---|---|---|---|---|
q |
string | да | — | 1–5 слов (или начал слов) через пробел, каждое 3–50 символов (буквы, цифры, «_», «-»); до 5 вариантов слова через «|» |
days |
integer | нет | 30 | Глубина данных в днях: 10, 30, 60, 90 |
category |
string | нет | — | Только каналы этой категории |
min_followers |
integer | нет | — | Только каналы не меньше N подписчиков |
channel_id |
integer | нет | — | Искать в одном канале |
page |
integer | нет | 1 | Номер страницы (1–10) |
per_page |
integer | нет | 100 | Записей на странице (1–100) |
| Поле | Тип | Описание |
|---|---|---|
published_at | datetime | Время публикации |
text | string | Текст поста |
post_link | string | Ссылка на пост (может быть пустой у старых постов) |
message_type | string | Тип сообщения: direct — собственный пост канала |
links | array<string> | Ссылки из поста |
mentioned_channels | array<object> | Упомянутые каналы MAX: [{max_channel_id, title, link}] |
images | array<string> | Изображения поста |
buttons | array<object> | Кнопки поста: [{text, url}] |
views_24h | integer | Охват за первые 24 часа после публикации |
views_total | integer | Максимальный известный охват |
is_ad | integer 0/1 | 1 — в посте есть ссылка на другой канал MAX (рекламное размещение) |
max_channel_id | integer | Канал, в котором вышел пост |
channel_title | string | Название канала |
channel_link | string | Ссылка на канал |
channel_followers_cnt | integer | Подписчики канала |
category | string | Категория канала |
curl -G "https://maxframe.ru/api/maxframe/publications/search/" \
-H "X-Api-Key: ваш_ключ" \
--data-urlencode "q=реклам канал" \
--data-urlencode "days=10" \
--data-urlencode "min_followers=1000"
import requests
r = requests.get(
"https://maxframe.ru/api/maxframe/publications/search/",
params={"q": "реклам канал", "days": "10", "min_followers": "1000"},
headers={"X-Api-Key": "ваш_ключ"},
timeout=10,
)
print(r.json())
const url = new URL("https://maxframe.ru/api/maxframe/publications/search/");
Object.entries({"q": "реклам канал", "days": "10", "min_followers": "1000"}).forEach(([k, v]) => url.searchParams.set(k, v));
const r = await fetch(url, { headers: { "X-Api-Key": "ваш_ключ" } });
console.log(await r.json());
{
"success": true,
"data": [
{
"published_at": "2026-10-18T17:56:39Z",
"text": "Подписывайтесь на «Радар России» — главные новости дня 👇",
"post_link": "https://max.ru/kerch_onlinee/AaFQKJQ2OUI",
"message_type": "direct",
"links": [
"https://max.ru/channel_radar_russia"
],
"mentioned_channels": [
{
"max_channel_id": 69464494268576,
"title": "Радар России",
"link": "https://max.ru/channel_radar_russia"
}
],
"images": [
"https://maxframe.ru/img/oneme/i?r=B0zLc4bX6k8W…"
],
"buttons": [],
"views_24h": 1353,
"views_total": 1353,
"is_ad": 1,
"max_channel_id": 68947474079904,
"channel_title": "Керчь онлайн",
"channel_link": "https://max.ru/kerch_onlinee",
"channel_followers_cnt": 33369,
"category": "Новости и СМИ"
}
],
"pagination": {
"page": 1,
"per_page": 100,
"count": 1,
"has_next": true
},
"meta": {
"api_version": "1.1.1",
"data_updated_at": "2026-10-19T09:10:00Z",
"request_cost": 1,
"requests_remaining": 26199
}
}
/api/maxframe/top/growth/
1 запрос
До 100 каналов с наибольшим приростом подписчиков за день, неделю или месяц.
| Параметр | Тип | Обязателен | По умолчанию | Описание |
|---|---|---|---|---|
period |
string | да | — | Период: day, week, month |
category |
string | нет | — | Только каналы этой категории |
| Поле | Тип | Описание |
|---|---|---|
rank | integer | Место в топе (1–100) |
max_channel_id | integer | ID канала |
title | string | Название канала |
link | string | Ссылка на канал |
avatar | string | URL аватарки |
followers_cnt | integer | Подписчики |
followers_growth | integer | Прирост подписчиков за период |
category | string | Категория |
category2 | string | Подкатегория |
is_official | integer 0/1 | Официальный канал |
is_a_plus_flag | integer 0/1 | Канал с отметкой A+ |
is_followers_fraud | integer 0/1 | Признаки накрутки подписчиков |
is_owner_fraud | integer 0/1 | Владелец замечен в мошенничестве |
curl -G "https://maxframe.ru/api/maxframe/top/growth/" \
-H "X-Api-Key: ваш_ключ" \
--data-urlencode "period=week"
import requests
r = requests.get(
"https://maxframe.ru/api/maxframe/top/growth/",
params={"period": "week"},
headers={"X-Api-Key": "ваш_ключ"},
timeout=10,
)
print(r.json())
const url = new URL("https://maxframe.ru/api/maxframe/top/growth/");
Object.entries({"period": "week"}).forEach(([k, v]) => url.searchParams.set(k, v));
const r = await fetch(url, { headers: { "X-Api-Key": "ваш_ключ" } });
console.log(await r.json());
{
"success": true,
"data": [
{
"rank": 1,
"max_channel_id": 71253668593887,
"title": "Россия 365. Новости",
"link": "https://max.ru/join/ORmuh2oA7qtuqkC3Vik0",
"avatar": "https://maxframe.ru/img/oneme/i?r=B1PLc4…",
"followers_cnt": 1301268,
"followers_growth": 5464,
"category": "Политика",
"category2": "Новости и СМИ",
"is_official": 0,
"is_a_plus_flag": 1,
"is_followers_fraud": 0,
"is_owner_fraud": 0
}
],
"meta": {
"api_version": "1.1.1",
"data_updated_at": "2026-10-19T09:10:00Z",
"request_cost": 1,
"requests_remaining": 26199
}
}
/api/maxframe/categories/
1 запрос
Пары категория / подкатегория и число каналов — значения для фильтров category и category2.
| Поле | Тип | Описание |
|---|---|---|
category | string | Категория — значение для фильтра category |
category2 | string | Подкатегория — значение для фильтра category2 |
channels_cnt | integer | Каналов в API с этой парой категорий |
curl -G "https://maxframe.ru/api/maxframe/categories/" \
-H "X-Api-Key: ваш_ключ"
import requests
r = requests.get(
"https://maxframe.ru/api/maxframe/categories/",
headers={"X-Api-Key": "ваш_ключ"},
timeout=10,
)
print(r.json())
const url = new URL("https://maxframe.ru/api/maxframe/categories/");
const r = await fetch(url, { headers: { "X-Api-Key": "ваш_ключ" } });
console.log(await r.json());
{
"success": true,
"data": [
{
"category": "Новости и СМИ",
"category2": "Политика",
"channels_cnt": 1240
}
],
"meta": {
"api_version": "1.1.1",
"data_updated_at": "2026-10-19T09:10:00Z",
"request_cost": 1,
"requests_remaining": 26199
}
}
/api/maxframe/status/
1 запрос
Когда обновлялся каждый набор данных и сколько в нём записей. Удобно для мониторинга свежести данных на вашей стороне.
| Поле | Тип | Описание |
|---|---|---|
api_version | string | Версия API |
marts | array<object> | Наборы данных: [{name, updated_at, rows}] — когда обновлены и сколько записей |
curl -G "https://maxframe.ru/api/maxframe/status/" \
-H "X-Api-Key: ваш_ключ"
import requests
r = requests.get(
"https://maxframe.ru/api/maxframe/status/",
headers={"X-Api-Key": "ваш_ключ"},
timeout=10,
)
print(r.json())
const url = new URL("https://maxframe.ru/api/maxframe/status/");
const r = await fetch(url, { headers: { "X-Api-Key": "ваш_ключ" } });
console.log(await r.json());
{
"success": true,
"data": {
"api_version": "1.1.1",
"marts": [
{
"name": "channel_card",
"updated_at": "2026-10-19T09:10:00Z",
"rows": 38767
},
{
"name": "channel_posts",
"updated_at": "2026-10-19T09:12:00Z",
"rows": 17197208
}
]
},
"meta": {
"api_version": "1.1.1",
"data_updated_at": null,
"request_cost": 1,
"requests_remaining": 26199
}
}
Существующие методы меняются только добавлением полей: прежние поля, их типы и тексты ошибок сохраняются. Машиночитаемое описание — openapi.json, интерактивное — справочник OpenAPI.
Пакет запросов к MaxFrame API на 30 дней. API-ключ появится в личном кабинете сразу после оплаты. Докупленные запросы суммируются с остатком.
1 вызов любого метода = 1 запрос. Запрос списывается за каждый ответ API с кодом 200 или 404; не больше 2 запросов в секунду с одного ключа. Если срок пакета закончился, неизрасходованные запросы сгорают; при покупке нового пакета остаток добавляется к нему, и весь баланс снова действует 30 дней. Подробнее — в пользовательском соглашении.
API-ключ появится в вашем личном кабинете MaxFrame сразу после покупки любого пакета API.
Там же в блоке «Мои API ключи» вы отслеживаете остаток запросов и срок действия пакета, копируете или перевыпускаете ключ и управляете автопродлением.
Купить