Находите упоминания бренда, продукта, бота или ссылки в публичных каналах каталога. Ответ приходит в JSON: текст поста, канал, дата, просмотры, пересылки и ссылка на пост. Формат ответа совместим с TGStat.
«скачать видео» найдёт и «скачал видеоролик». Нужна точность: включите строгий поиск параметром strict=1.
Слова через OR, исключения через минус, фразы в кавычках, минус-слова отдельным параметром.
Период, язык, рубрика каталога, минимум просмотров, пагинация.
Метод usage/stat показывает тариф, расход запросов и ключевых слов за месяц.
Запрос
GET https://api.botopedia.io/v1/posts/search ?token=ВАШ_КЛЮЧ &q="скачать видео" &period=30d &language=ru &limit=50 # или ключ в заголовке: # Authorization: Bearer ВАШ_КЛЮЧ
Ответ (структура, значения для примера)
{
"status": "ok",
"response": {
"count": 1,
"total_count": 128,
"items": [{
"id": 1532,
"channel": "@channel_name",
"channel_title": "Название канала",
"date": "2026-11-07T10:14:00Z",
"text": "Текст поста…",
"snippet": "…фрагмент с <mark>найденным</mark>…",
"views": 18400, "forwards": 212,
"link": "https://t.me/channel_name/1532"
}]
}
}| Параметр | Что делает | По умолчанию |
|---|---|---|
q | Текст запроса: слова, фраза в кавычках, OR, минус-слова | обязателен |
minusWords | Слова, которых в посте быть не должно, через пробел | нет |
period | Глубина поиска: 12h, 1d, 7d, 2w, 30d. Либо startDate и endDate в формате unix | 10 дней или меньше по тарифу |
strict / strongSearch | Строгий поиск без морфологии (1 или 0) | 0 |
language, category | Язык и рубрика канала | все |
min_views | Только посты от N просмотров | 0 |
limit, offset | Сколько постов вернуть (до 100) и с какого начать (до 1000) | 20 и 0 |
Методы: /v1/posts/search, /v1/usage/stat, /v1/health. Ошибки приходят в виде {"status":"error","error":"код"}: empty_token, token_invalid (401), period_beyond_plan (403), quota_requests_reached и flood_control_60 (429).
Это лимиты ключей. Стоимость платных тарифов и приём оплаты пока не запущены: ключ выдаётся по заявке через форму на странице «Контакты».
Только из публичных каналов каталога Botopedia, которые открыты любому человеку в Telegram. Закрытые каналы и личная переписка в поиск не попадают.
Посты попадают в индекс по мере сбора данных по каналам. Гарантий по минутам мы не даём.
Да. Подтвердите, что канал ваш, на странице «Убрать канал», и мы исключим его из каталога и из поиска.
API вернёт ошибку 429 (quota_requests_reached) до начала следующего месяца. При слишком частых запросах приходит flood_control_60 и заголовок Retry-After.
Сейчас ключи выдаются по заявке: напишите нам через форму на странице «Контакты» и укажите, для чего нужен поиск. Автоматическая выдача ключей и приём оплаты ещё не запущены.