REST API · версия 1.1.1

MaxFrame API

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

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

  1. Купите пакет запросов — ключ появится в личном кабинете в блоке «Мои API ключи».
  2. Передайте ключ в заголовке X-Api-Key (или параметром ?api_key=).
  3. Вызывайте любой метод — 1 вызов = 1 запрос из пакета.
Базовый URL
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).
  • Время во всех новых полях — ISO 8601 в UTC с суффиксом Z. Поле updated_at сохраняет прежний формат без часового пояса.
  • Списки — параметры page (с 1) и per_page (1–100, по умолчанию 100). Общего числа записей нет: есть has_next.

Лимиты и цена запросов

  • 1 вызов любого метода = 1 запрос из пакета, при любом per_page.
  • Запрос списывается за ответы 200 и 404. Ответы 400, 401, 402, 429, 500 и 504 запросы не тратят.
  • Не больше 2 запросов в секунду с одного ключа. Сверх лимита — ответ 429 с заголовком Retry-After: 1, запрос не списывается.
  • Таймаут запроса к базе — 5 секунд. Не уложились — ответ 504, запрос не списывается.
Заголовки ответа
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_codeHTTPКогдаСписывается
invalid_api_key401Ключ не передан или не найденнет
balance_exhausted402Запросы кончились или срок пакета истёк (+ поле renew_url)нет
bad_request400Неверный параметр (+ поле param с именем параметра)нет
not_found404Канал не найден или его данные старше 7 днейда
rate_limited429Больше 2 запросов в секунду с одного ключа (+ заголовок Retry-After: 1)нет
server_error500Ошибка базы данныхнет
timeout504Запрос не уложился в 5 секунд — сузьте период или фильтрынет

Свежесть данных

  • Данные пересчитываются раз в 4 часа. Когда обновлён каждый набор — в meta.data_updated_at и в методе /status/.
  • followers_updated_at — время последнего замера подписчиков канала.
  • is_stale = 1 — замеру больше 36 часов (например, из канала удалили бота MaxFrame). Канал отдаётся с последними известными данными.
  • Каналы без обновлений больше 7 дней не отдаются: карточка отвечает 404.
  • Посты, реклама и поиск хранятся за 90 дней; глубина выбирается параметром days: 10, 30, 60 или 90 (по умолчанию 30).

Как работает поиск

  • Ищем по началу слова: max найдёт и max, и maxframe.
  • Не уверены в окончании — пишите начало: реклам найдёт реклама, рекламу, рекламный.
  • Несколько слов через пробел — в посте должны быть все, в любом месте: q=скидка промокод.
  • Любое из слов — через |: q=wildberries|ozon.
  • Регистр и «ё»/«е» не важны. Слово — от 3 символов; чем оно короче, тем больше лишнего (кот найдёт и «который»).
  • Быстрее всего — с 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

Методы

GET /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)
Поля ответа (элемент data)
ПолеТипОписание
max_channel_idintegerУникальный ID канала
titlestringНазвание канала
descriptionstringОписание канала
avatarstringURL аватарки
linkstringСсылка на канал
updated_atdatetimeВремя обновления данных канала (формат v1.0)
categorystringОсновная категория; пусто — канала нет в карточках API
category2stringПодкатегория
followers_cntintegerПодписчики по последнему замеру
followers_change_24hintegerИзменение подписчиков за 24 часа
followers_change_7dintegerИзменение подписчиков за 7 дней
followers_change_30dintegerИзменение подписчиков за 30 дней
views_24hinteger | nullОхват последнего поста за 24 часа
avg_views_7dintegerСредний охват поста за 24 часа, по постам за 7 дней
er_avg_7dnumberСредний ER за 7 дней, %
last_post_atdatetime | nullВремя последней публикации
posts_7dintegerПубликаций за 7 дней
is_followers_fraudinteger 0/1Признаки накрутки подписчиков
is_owner_fraudinteger 0/1Владелец замечен в мошенничестве
is_officialinteger 0/1Официальный канал
is_a_plus_flaginteger 0/1Канал с отметкой A+
followers_updated_atdatetime | nullВремя последнего замера подписчиков
is_staleinteger 0/11 — данным больше 36 часов или канала нет в карточках API
maxframe_urlstringСтраница канала на 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"
Пример ответа
{
  "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
  }
}
GET /api/maxframe/channel/by-id/<channel_id>/ 1 запрос

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

Полная карточка канала: подписчики и их динамика, частота публикаций, охваты, реклама, пометки накрутки. Каналы без обновлений больше 7 дней не отдаются (404).

Параметры
ПараметрТипОбязателенПо умолчаниюОписание
channel_id в пути integer да — max_channel_id канала
Поля ответа
ПолеТипОписание
max_channel_idintegerУникальный ID канала
titlestringНазвание канала
descriptionstringОписание канала
avatarstringURL аватарки
linkstringСсылка на канал (https://max.ru/...)
categorystringОсновная категория (значения — из /categories/)
category2stringПодкатегория
followers_cnt_todayintegerПодписчики по последнему замеру
followers_historyobjectПодписчики за последние 10 дней: {"ГГГГ-ММ-ДД": число}
is_a_plus_flaginteger 0/1Канал с отметкой A+ (1 — да)
views_24hintegerОхват последнего поста за 24 часа
views_48hintegerОхват последнего поста за 48 часов
er_24hintegerER за 24 часа, % (охват / подписчики)
er_48hintegerER за 48 часов, %
updated_atdatetimeВремя обновления данных канала (формат v1.0, без часового пояса)
followers_updated_atdatetimeВремя последнего замера подписчиков
is_staleinteger 0/11 — последнему замеру больше 36 часов (например, из канала удалили бота MaxFrame)
followers_change_24hintegerИзменение подписчиков за 24 часа
followers_change_7dintegerИзменение подписчиков за 7 дней
followers_change_30dintegerИзменение подписчиков за 30 дней
last_post_atdatetime | nullВремя последней публикации за 90 дней; null — публикаций не было
posts_24hintegerПубликаций за 24 часа
posts_7dintegerПубликаций за 7 дней
posts_30dintegerПубликаций за 30 дней
avg_posts_per_day_30dnumberСреднее число публикаций в день за 30 дней
avg_views_7dintegerСредний охват поста за первые 24 часа, по постам за 7 дней
er_avg_7dnumberavg_views_7d / подписчики × 100, не больше 100
ads_received_7dintegerСколько разных каналов рекламировали этот канал за 7 дней
ads_received_30dintegerСколько разных каналов рекламировали этот канал за 30 дней
ads_placed_30dintegerСколько разных каналов этот канал рекламировал у себя за 30 дней
is_followers_fraudinteger 0/1Признаки накрутки подписчиков
is_owner_fraudinteger 0/1Владелец замечен в мошенничестве
fraud_reasonstringПричина пометки (пусто, если пометок нет)
is_officialinteger 0/1Официальный канал
shortnamestringКороткое имя канала
maxframe_urlstringСтраница канала на maxframe.ru
Пример запроса
curl -G "https://maxframe.ru/api/maxframe/channel/by-id/71253668593887/" \
     -H "X-Api-Key: ваш_ключ"
Пример ответа
{
  "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
  }
}
GET /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)
Поля ответа (элемент data)
ПолеТипОписание
published_atdatetimeВремя публикации
textstringТекст поста
post_linkstringСсылка на пост (может быть пустой у старых постов)
message_typestringТип сообщения: direct — собственный пост канала
linksarray<string>Ссылки из поста
mentioned_channelsarray<object>Упомянутые каналы MAX: [{max_channel_id, title, link}]
imagesarray<string>Изображения поста
buttonsarray<object>Кнопки поста: [{text, url}]
views_24hintegerОхват за первые 24 часа после публикации
views_totalintegerМаксимальный известный охват
is_adinteger 0/11 — в посте есть ссылка на другой канал MAX (рекламное размещение)
Пример запроса
curl -G "https://maxframe.ru/api/maxframe/channel/68947474079904/posts/" \
     -H "X-Api-Key: ваш_ключ" \
     --data-urlencode "days=10" \
     --data-urlencode "per_page=20"
Пример ответа
{
  "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
  }
}
GET /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)
Поля ответа (элемент data)
ПолеТипОписание
advertiser_channel_idintegerКанал, в котором вышла реклама
advertiser_titlestringНазвание канала
advertiser_linkstringСсылка на канал
advertiser_avatarstringURL аватарки
advertiser_followers_cntintegerПодписчики канала
published_atdatetimeВремя публикации рекламного поста
post_textstringТекст поста
imagesarray<string>Изображения поста
buttonsarray<object>Кнопки поста
views_24hintegerОхват поста за 24 часа
views_totalintegerМаксимальный известный охват поста
advertiser_is_fraudinteger 0/11 — у канала-рекламодателя есть пометка накрутки или мошенничества
Пример запроса
curl -G "https://maxframe.ru/api/maxframe/channel/74017239111056/ads/received/" \
     -H "X-Api-Key: ваш_ключ" \
     --data-urlencode "days=30"
Пример ответа
{
  "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
  }
}
GET /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)
Поля ответа (элемент data)
ПолеТипОписание
advertised_channel_idintegerКанал, который рекламировали
advertised_titlestringНазвание канала
advertised_linkstringСсылка на канал
advertised_avatarstringURL аватарки
advertised_followers_cntintegerПодписчики канала
published_atdatetimeВремя публикации рекламного поста
post_textstringТекст поста
imagesarray<string>Изображения поста
buttonsarray<object>Кнопки поста
views_24hintegerОхват поста за 24 часа
views_totalintegerМаксимальный известный охват поста
advertised_is_fraudinteger 0/11 — у рекламируемого канала есть пометка накрутки или мошенничества
Пример запроса
curl -G "https://maxframe.ru/api/maxframe/channel/74241621463071/ads/placed/" \
     -H "X-Api-Key: ваш_ключ" \
     --data-urlencode "days=30"
Пример ответа
{
  "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
  }
}
GET /api/maxframe/top/growth/ 1 запрос

Топ роста

До 100 каналов с наибольшим приростом подписчиков за день, неделю или месяц.

Параметры
ПараметрТипОбязателенПо умолчаниюОписание
period string да — Период: day, week, month
category string нет — Только каналы этой категории
Поля ответа
ПолеТипОписание
rankintegerМесто в топе (1–100)
max_channel_idintegerID канала
titlestringНазвание канала
linkstringСсылка на канал
avatarstringURL аватарки
followers_cntintegerПодписчики
followers_growthintegerПрирост подписчиков за период
categorystringКатегория
category2stringПодкатегория
is_officialinteger 0/1Официальный канал
is_a_plus_flaginteger 0/1Канал с отметкой A+
is_followers_fraudinteger 0/1Признаки накрутки подписчиков
is_owner_fraudinteger 0/1Владелец замечен в мошенничестве
Пример запроса
curl -G "https://maxframe.ru/api/maxframe/top/growth/" \
     -H "X-Api-Key: ваш_ключ" \
     --data-urlencode "period=week"
Пример ответа
{
  "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
  }
}
GET /api/maxframe/categories/ 1 запрос

Справочник категорий

Пары категория / подкатегория и число каналов — значения для фильтров category и category2.

Поля ответа
ПолеТипОписание
categorystringКатегория — значение для фильтра category
category2stringПодкатегория — значение для фильтра category2
channels_cntintegerКаналов в API с этой парой категорий
Пример запроса
curl -G "https://maxframe.ru/api/maxframe/categories/" \
     -H "X-Api-Key: ваш_ключ"
Пример ответа
{
  "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
  }
}
GET /api/maxframe/status/ 1 запрос

Статус данных

Когда обновлялся каждый набор данных и сколько в нём записей. Удобно для мониторинга свежести данных на вашей стороне.

Поля ответа
ПолеТипОписание
api_versionstringВерсия API
martsarray<object>Наборы данных: [{name, updated_at, rows}] — когда обновлены и сколько записей
Пример запроса
curl -G "https://maxframe.ru/api/maxframe/status/" \
     -H "X-Api-Key: ваш_ключ"
Пример ответа
{
  "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
  }
}

Изменения

v1.1.1 — 2026-11-11
  • Поиск по публикациям ищет по началу слова: «max» найдёт и max, и maxframe, «реклам» — реклама, рекламу, рекламный. Перечислять формы слова через «|» больше не нужно; параметры и формат ответа прежние.
v1.1.0 — 2026-10-19
  • Новые методы: посты канала с охватами, кто рекламировал канал и кого рекламировал он, поиск по публикациям, топ роста, справочник категорий, статус данных.
  • Карточка канала: изменение подписчиков за 24 ч / 7 / 30 дней, дата и частота публикаций, средний охват, реклама, пометки накрутки, followers_updated_at и is_stale.
  • Список каналов: фильтры, сортировка, per_page, стабильный порядок по max_channel_id.
  • Каналы больше не пропадают из API после полуночи; данные старше 36 часов помечаются is_stale, старше 7 дней не отдаются.
  • Во всех ответах — блок meta, в ошибках — error_code; ограничение 2 запроса в секунду на ключ пакета.
v1.0.0 — 2026-06-15
  • Список каналов, карточка канала по ID и по ссылке.

Существующие методы меняются только добавлением полей: прежние поля, их типы и тексты ошибок сохраняются. Машиночитаемое описание — openapi.json, интерактивное — справочник OpenAPI.

Пакеты API

Пакет запросов к MaxFrame API на 30 дней. API-ключ появится в личном кабинете сразу после оплаты. Докупленные запросы суммируются с остатком.

Тестовый 1 раз на аккаунт
29₽
580,00 ₽ за 1 000 запросов
  • 50 запросов
  • Действует 30 дней с момента оплаты
  • Все методы API: каналы, посты, реклама, поиск, топы
  • Чтобы попробовать API на своих задачах
Старт
599₽
119,80 ₽ за 1 000 запросов
  • 5 000 запросов
  • Действует 30 дней с момента оплаты
  • Все методы API: каналы, посты, реклама, поиск, топы
  • Остаток и срок — в личном кабинете
Базовый Популярный
1 199₽
47,96 ₽ за 1 000 запросов
  • 25 000 запросов
  • Действует 30 дней с момента оплаты
  • Все методы API: каналы, посты, реклама, поиск, топы
  • Остаток и срок — в личном кабинете
Продвинутый
2 019₽
20,19 ₽ за 1 000 запросов
  • 100 000 запросов
  • Действует 30 дней с момента оплаты
  • Все методы API: каналы, посты, реклама, поиск, топы
  • Остаток и срок — в личном кабинете
Бизнес
3 219₽
10,73 ₽ за 1 000 запросов
  • 300 000 запросов
  • Действует 30 дней с момента оплаты
  • Все методы API: каналы, посты, реклама, поиск, топы
  • Остаток и срок — в личном кабинете
Максимальный Самый выгодный
5 190₽
5,19 ₽ за 1 000 запросов
  • 1 000 000 запросов
  • Действует 30 дней с момента оплаты
  • Все методы API: каналы, посты, реклама, поиск, топы
  • Остаток и срок — в личном кабинете

1 вызов любого метода = 1 запрос. Запрос списывается за каждый ответ API с кодом 200 или 404; не больше 2 запросов в секунду с одного ключа. Если срок пакета закончился, неизрасходованные запросы сгорают; при покупке нового пакета остаток добавляется к нему, и весь баланс снова действует 30 дней. Подробнее — в пользовательском соглашении.

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

API-ключ появится в вашем личном кабинете MaxFrame сразу после покупки любого пакета API.

Там же в блоке «Мои API ключи» вы отслеживаете остаток запросов и срок действия пакета, копируете или перевыпускаете ключ и управляете автопродлением.

Купить