Методы API Stat

Базовый адрес — https://beta.stat.tapbox.ru/api. Все методы — GET, ключ передаётся в заголовке X-API-Key. Большинство методов канала принимают chat_id — его отдаёт карточка канала.

Каталог и поиск каналов

Список и подбор каналов

GET /api/channels

Подбор каналов, чатов и ботов по тематике, региону, размеру аудитории и метрикам.

Параметр	Тип	Описание
`type`	строка	`channel` — каналы, `chat` — чаты, `bot` — боты. Без параметра — все типы
`search`	строка	Поиск по названию и описанию
`category`	строка	Точное название тематики из списка тематик
`region`	строка	Точное название региона из списка регионов
`subs_min`, `subs_max`	число	Границы числа подписчиков
`reach_min`, `reach_max`	число	Границы среднего охвата поста
`err_min`, `err_max`	число	Границы ERR, %
`ci_min`, `ci_max`	число	Границы индекса цитирования
`lang`	строка	Язык канала, например `Русский`
`verified`	`1`	Только верифицированные
`sort`	строка	`subs` — подписчики, `reach` — охват, `err` — ERR, `ci` — индекс цитирования, `posts` — число постов, `recent` — недавно добавленные, `title` — по названию, `g_today`, `g_yest`, `g_week`, `g_month` — прирост за сегодня, вчера, неделю, месяц. Для ботов: `popular`, `likes`
`order`	строка	`desc` (по умолчанию) или `asc`
`norank`	`1`	Вместе с `search`: сортировать по `sort`, а не по релевантности
`limit`	число	1–200, по умолчанию 50
`page`	число	Страница, начиная с 1

curl -H "X-API-Key: tbx_ваш_ключ" \
  "https://beta.stat.tapbox.ru/api/channels?type=channel&region=Москва&subs_min=10000&sort=err&limit=20"

Ответ: items — массив карточек (поля — как у карточки канала), total — сколько всего подходит под фильтр, page, limit, subs_sum — суммарная аудитория найденного.

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

GET /api/channels/{handle}

Карточка канала, чата или бота. Вместо {handle} — слаг из ссылки max.ru/…, числовой chat_id или точное название.

curl -H "X-API-Key: tbx_ваш_ключ" "https://beta.stat.tapbox.ru/api/channels/newmedia"

{
  "chat_id": -68089202013653,
  "handle": "newmedia",
  "title": "New Media",
  "link": "https://max.ru/newmedia",
  "description": "Первый канал о медиа…",
  "chat_type": "channel",
  "category": "Маркетинг, PR, реклама",
  "region": "Россия",
  "lang": "Русский",
  "participants_count": 11579,
  "avg_reach": 4150,
  "err_pct": 35.8,
  "citation_idx": 237,
  "g_today": 0,
  "g_yest": -16,
  "g_week": -113,
  "g_month": -72,
  "messages_count": 1696,
  "verified": false,
  "is_public": true,
  "first_post_epoch": 1753356982,
  "last_post_epoch": 1789052527
}

Поле	Что это
`participants_count`	Подписчики
`avg_reach`	Средний охват поста без репостов
`err_pct`	ERR — охват поста к числу подписчиков, %
`citation_idx`	Индекс цитирования
`g_today`, `g_yest`, `g_week`, `g_month`	Прирост подписчиков за сегодня, вчера, 7 и 30 дней
`first_post_epoch`, `last_post_epoch`	Первый и последний пост, секунды Unix

Если канал не найден — 404.

Тематики и регионы

GET /api/channels/categories и GET /api/channels/regions

Справочники для фильтров category и region: название → количество каналов.

{
  "counts": {
    "Блоги": 4890,
    "Бизнес и стартапы": 3170,
    "Новости и СМИ": 6447
  }
}

Категории ботов и лайки

GET /api/channels/bot-categories — категории каталога ботов: items с полями name, count, и total.
GET /api/channels/likes?chat_id=… — число лайков бота в каталоге: поле count.

Сами боты ищутся через список каналов с type=bot.

Метрики канала

Все методы этого раздела принимают обязательный параметр chat_id.

Метод	Что возвращает
`GET /api/channels/subs`	Подписчики по дням: `items` — `d` (дата), `subs`
`GET /api/channels/err`	Сводка вовлечённости: `subs`, `avg_reach`, `err`, `err24` (ERR за первые сутки), `err_24h`, `err_48h`, `posts`, `reposts_excluded`
`GET /api/channels/reach-timeline`	Охват по дням: `items` — `d`, `reach` (средний охват), `err`, `total` (сумма просмотров)
`GET /api/channels/posts-summary`	Сколько публикаций: `total`, `month`, `week`, `yesterday` и `daily` — `d`, `c`
`GET /api/channels/posts-timeline`	Публикации по дням: `items` — `d`, `p` (посты), `r` (репосты)
`GET /api/channels/posts-heatmap`	Когда канал публикует: `items` — `d`, `h` (час по Москве), `c` (количество)
`GET /api/channels/posts-hourly`	Набор просмотров последних постов по часам: `items` — `seq`, `url`, `when`, `views`, `hours` — `h` (час жизни поста), `cum` (просмотров к этому часу). `limit` — сколько постов
`GET /api/channels/history`	История изменений: `title`, `username`, `description` — массивы `value`, `date`

curl -H "X-API-Key: tbx_ваш_ключ" \
  "https://beta.stat.tapbox.ru/api/channels/subs?chat_id=-68089202013653"

{
  "items": [
    { "d": "2026-09-09", "subs": 11595 },
    { "d": "2026-09-10", "subs": 11579 }
  ]
}

Публикации

Лента канала

GET /api/channels/posts

Параметр	Тип	Описание
`chat_id`	число	Обязательный
`period`	строка	`month` — с начала текущего месяца по Москве, `30d` — последние 30 дней. Без параметра — вся лента
`day`	дата	`ГГГГ-ММ-ДД` — публикации за один день
`sort`	строка	`date` (по умолчанию) или `views`
`limit`	число	1–5000, по умолчанию 60
`seq`	строка	Вернуть один пост

{
  "items": [
    {
      "seq": "116289012815960110",
      "url": "https://max.ru/newmedia/…",
      "text": "❗️ФАС не будет наказывать…",
      "when": "25.03.2026 12:05",
      "epoch": 1774429517,
      "views": 564889,
      "images": [],
      "video": false,
      "repost_from": "РИА Новости",
      "repost_handle": "ria",
      "deleted": false,
      "edited": false
    }
  ],
  "total": 1698
}

Разбор поста

GET /api/channels/post-views?chat_id=…&seq=… — кривая набора просмотров: views, subscribers, err, posted_at и series — точки ряда.
GET /api/channels/post-citations?chat_id=…&seq=… — кто процитировал или репостнул пост: items.

Параметр	Описание
`period`	`today` (по умолчанию), `yesterday`, `day_before`, `7d`, `week`, `prev_week`, `month`, `prev_month`, `all`
`metric`	`views` (по умолчанию) или `reposts`
`category`, `region`	Фильтры по тематике и региону канала
`limit`	1–100, по умолчанию 50

Индекс цитирования

Все методы принимают chat_id.

Метод	Что возвращает
`GET /api/channels/citation`	Входящие (`incoming`) и исходящие (`outgoing`) упоминания и репосты: сколько каналов и упоминаний, список до 100 источников
`GET /api/channels/citation-breakdown`	Из чего сложился индекс: `total`, разбивка по типу упоминания (`byType`), размеру цитирующих (`bySubs`), тематике (`byCategory`) и региону (`byRegion`)
`GET /api/channels/citation-history`	Индекс по дням: `items` — `d`, `ci`
`GET /api/channels/repost-sources`	Чьи посты канал репостит (`sources`) и кто репостит его (`amplifiers`)

Сводка по рынку

Метод	Что возвращает
`GET /api/channels/stats`	Объём базы: `channels`, `chats`, `bots`, `posts`, `posts_today`, `subs`, `views_total`, `categories`
`GET /api/channels/top-channels?metric=reach`	Лидеры по охвату (`metric=reach`) или по ERR (`metric=err`): `items` — `handle`, `title`, `value`
`GET /api/channels/growth-leaders`	Лидеры прироста подписчиков: `items` — `handle`, `title`, `category`, `participants_count`, `gain`
`GET /api/channels/category-growth`	Прирост по тематикам: `items` — `name`, `chans` (каналов), `base`, `delta`, `pct`
`GET /api/channels/best-time`	Вовлечённость по дням недели и часам по всей базе: `items` — `dow`, `hr`, `er`, `n`
`GET /api/channels/content-types`	Доли типов контента: `items` — `n` (тип), `v` (количество)

Методы API Stat

Каталог и поиск каналов

Список и подбор каналов

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

Тематики и регионы

Похожие боты

Категории ботов и лайки

Метрики канала

Публикации

Лента канала

Разбор поста

Популярные публикации и рейтинг

Индекс цитирования

Сводка по рынку

Каталог и поиск каналов​

Список и подбор каналов​

Карточка канала​

Тематики и регионы​

Похожие боты​

Категории ботов и лайки​

Метрики канала​

Публикации​

Лента канала​

Разбор поста​

Популярные публикации и рейтинг​

Индекс цитирования​

Сводка по рынку​

Каталог и поиск каналов

Список и подбор каналов

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

Тематики и регионы

Похожие боты

Категории ботов и лайки

Метрики канала

Публикации

Лента канала

Разбор поста

Популярные публикации и рейтинг

Индекс цитирования

Сводка по рынку