Публичное MAX API

Бесплатное публичное API для получения данных о MAX-каналах, группах и ботах. Базовый URL: https://parser.maxlist.net

Ограничения

GETтолько GET-запросы

JSONформат ответа

Эндпоинты

GEThttps://parser.maxlist.net/:username

Канал

Возвращает актуальные данные MAX-канала по username: название, описание, аватар и количество подписчиков.

Параметры пути

Параметр	Тип	Обязательный	Описание
`username`	string	да	Username канала без @ (например: bbcrussian)

Параметрusername

Типstring

Обязательныйда

ОписаниеUsername канала без @ (например: bbcrussian)

Пример запроса

curl "https://parser.maxlist.net/bbcrussian"

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

{
  "success": true,
  "data": {
    "username": "bbcrussian",
    "name": "BBC News — Русская служба",
    "description": "Русская служба Би-би-си — международные новости 24/7",
    "avatar": "https://cdn1-max.cdnvideo.ru/...",
    "subscribers": 348200,
    "link": "https://max.ru/bbcrussian"
  },
  "timestamp": "2026-03-30T00:00:00.000Z"
}

GEThttps://parser.maxlist.net/:username

Группа

Возвращает актуальные данные MAX-группы по username: название, описание, аватар и количество участников.

Параметры пути

Параметр	Тип	Обязательный	Описание
`username`	string	да	Username группы без @ (например: maxusers)

Параметрusername

Типstring

Обязательныйда

ОписаниеUsername группы без @ (например: maxusers)

Пример запроса

curl "https://parser.maxlist.net/maxusers"

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

{
  "success": true,
  "data": {
    "username": "maxusers",
    "name": "MAX — пользователи",
    "description": "Обсуждение мессенджера MAX",
    "avatar": "https://cdn1-max.cdnvideo.ru/...",
    "subscribers": 15400,
    "link": "https://max.ru/maxusers"
  },
  "timestamp": "2026-03-30T00:00:00.000Z"
}

GEThttps://parser.maxlist.net/:username

Бот

Возвращает актуальные данные MAX-бота по username: название, описание и аватар.

Параметры пути

Параметр	Тип	Обязательный	Описание
`username`	string	да	Username бота без @ (например: weatherbot)

Параметрusername

Типstring

Обязательныйда

ОписаниеUsername бота без @ (например: weatherbot)

Пример запроса

curl "https://parser.maxlist.net/weatherbot"

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

{
  "success": true,
  "data": {
    "username": "weatherbot",
    "name": "Погода",
    "description": "Прогноз погоды для любого города",
    "avatar": "https://cdn1-max.cdnvideo.ru/...",
    "subscribers": null,
    "link": "https://max.ru/weatherbot"
  },
  "timestamp": "2026-03-30T00:00:00.000Z"
}

Ошибки

Код	Описание
`400`	Некорректный username
`404`	Ресурс не найден на max.ru
`502`	Ошибка при получении данных с max.ru