Методы API Search

Методы этой страницы входят в продукт API Search. Если он не подключён к ключу, сервер ответит 403 с кодом product.

Поиск по публикациям

GET /api/posts/search

Полнотекстовый поиск по всем публикациям каналов, чатов и ботов MAX с учётом словоформ русского языка.

Параметр	Тип	Описание
q	строка	Поисковый запрос. Обязательный
exact	1	Искать точную фразу, без словоформ
exclude	строка	Минус-слова через пробел
from, to	дата	Период ГГГГ-ММ-ДД, обе границы включительно
sort	строка	date (по умолчанию, сначала новые) или views
hide_reposts	1	Не показывать репосты
hide_deleted	1	Не показывать удалённые посты
source	строка	Только channel, chat или bot
category	строка	Только каналы этой тематики
chat_id	число	Искать в одном канале
limit	число	1–100, по умолчанию 40
page	число	Страница, начиная с 1

curl -G -H "X-API-Key: tbx_ваш_ключ" "https://beta.stat.tapbox.ru/api/posts/search" \
  --data-urlencode "q=Tapbox" --data-urlencode "from=2026-09-01" \
  --data-urlencode "hide_reposts=1" --data-urlencode "sort=views"

{
  "items": [
    {
      "chat_id": -70712486887662,
      "handle": "id302500195328_biz",
      "title": "Экосистема Tapbox",
      "chat_type": "channel",
      "participants_count": 34178,
      "seq": "117249476869031114",
      "url": "https://max.ru/…",
      "text": "…",
      "when": "11.09.2026 03:03",
      "views": 1520,
      "is_repost": false
    }
  ],
  "total": 698,
  "capped": false,
  "count_cap": 5000,
  "sources": [
    { "chat_id": -70712486887662, "title": "Экосистема Tapbox", "count": 183 }
  ],
  "timeline": [
    { "d": "2026-09-10", "posts": 4, "views": 2310 }
  ]
}

Поле	Что это
total	Сколько постов найдено. Счёт останавливается на count_cap
capped	true, если найдено не меньше count_cap и точное число больше
sources	Каналы, где чаще всего встречается запрос, с числом постов count
timeline	Сколько постов и просмотров по дням

sources и timeline приходят на первой странице.

Упоминания канала

Кто упоминает и репостит канал. Оба метода принимают chat_id.

Динамика

GET /api/channels/mentions-timeline?chat_id=…

{
  "items": [
    { "d": "2026-09-09", "mentions": 3, "reposts": 5 },
    { "d": "2026-09-10", "mentions": 1, "reposts": 2 }
  ]
}

Список упоминаний

GET /api/channels/mentions-list?chat_id=…

Параметр	Описание
month	Месяц ГГГГ-ММ
author	chat_id цитирующего канала — только его упоминания
dil	Тип упоминания: 0 — индивидуальное, 1–3 — в подборках разного размера
subs	Размер цитирующего канала: от 0 (до 1 тыс. подписчиков) до 4 (более 100 тыс.)
cat, reg	Тематика и регион цитирующего канала

Ответ: items — пост с упоминанием: author_title, author_link, author_subs, kind (mention или repost), text, url, when, views.