Как работает tgadsspy — открытая методология индексирования рекламы Telegram
Полная документация о том, как мы индексируем данные Telegram Ads, что фиксируем, что не фиксируем и как исследователи могут верифицировать наши числа. Открытая методология, пригодная для цитирования.
Telegram Ads Spy — независимый OSINT-проект, индексирующий каждую рекламную кампанию на официальной платформе Telegram Ads — как в кабинете TON, так и в кабинете EUR — в режиме реального времени. Этот документ является канонической справкой для исследователей, журналистов и команд конкурентной разведки, которые хотят верифицировать или цитировать наши данные.
Что мы индексируем#
- Спонсорские сообщения платформы Telegram Ads — объявления, показываемые через официальный API-эндпоинт
channels.getSponsored, который Telegram открывает любому аутентифицированному пользователю, просматривающему публичный широковещательный канал. - Платные размещения в каналах (TON) — публичные посты в широковещательных каналах, где креатив отмечен паттерном CTA-URL, который мы распознаём как платное размещение. Обнаружение основано на текстовых паттернах + структуре CTA-URL, а не на проприетарной логике.
- Метаданные каналов — количество подписчиков, аватар, описание, основной язык, категория. Получаются через
channels.getFullChannel.
Мы никогда не индексируем:
- Приватные каналы, группы только по приглашению или что-либо за экраном запроса на вступление.
- Личные чаты или групповые разговоры между идентифицируемыми пользователями.
- Контент, защищённый флуд-лимитами Telegram или DMCA-флагами.
Как канал попадает в наш пул#
Четыре пути:
- Батч-сиды — тщательно составленные списки в
scripts/batches/, сгруппированные по языку и нише. - Авто-дискавери — cron
Telegram Ads Spy-discoverопрашиваетcontacts.searchTelegram с 202 keyword-сидами каждый час. - Пользовательский сабмит — любой может вставить хэндл канала на /submit, и он попадёт в очередь.
- CTA-извлечение — когда рекламный креатив ссылается на
t.me/{handle}, мы автоматически добавляем{handle}в пул.
Частота обновлений#
| Компонент | Период |
|---|---|
| Резолвер (обновление метаданных) | Каждые 10 минут |
| Ingest tier S (топ-каналы) | Каждые 5 минут |
| Ingest tier A (активные каналы) | Каждые 30 минут |
| Ingest tier B (хвостовые каналы) | Каждые 4 часа |
| Discover (новые keyword-сиды) | Каждый час |
| Зеркалирование медиа (gramesh → постоянный URL) | Каждые 5 минут |
Словарь данных#
Каждый рекламный креатив в нашем индексе содержит:
id— стабильный CUID, постоянный при перестройках.text+title— необработанный копи креатива в том виде, в каком его отдаёт Telegram.paymentSource—TONилиEUR_ADS_CABINET.niche— один из 18 классификаторных бакетов (crypto, gambling, trading, dating, health…).geo— ISO alpha-2 код, определяется по языку креатива + CTA-домену.lang— определённый язык креатива (ISO 639-1).firstSeenAt+lastSeenAt— UTC-временны́е метки, стабильные.reachEstimate+spendEstimate— производные от аудитории канала × рыночный CPM.advertiser— структурированная сущность с{ name, domain, tgUsername, slug }.
Полная схема: /api-docs.
Как мы оцениваем охват и расходы#
Для каждого креатива:
- Суммируем аудиторию (подписчиков) всех каналов, где мы наблюдали этот креатив.
- Применяем средний коэффициент просмотров из статистики наших каналов (
avgViews / members). - Умножаем на текущий рыночный CPM-бенчмарк для ниши + гео креатива.
Оценки расходов — бенчмарки, а не бухгалтерский учёт. Они отражают разумную рыночную ставку для отображаемого объёма, а не фактические расходы рекламодателя в кабинете. Используйте их для относительного сравнения между рекламодателями, но не для точной атрибуции.
Чего мы никогда не делаем#
- Перепродажа доступа к кабинету Telegram.
- Заявления об аффилированности с Telegram FZ-LLC.
- Оплата доступа к приватным каналам или инсайдерских данных.
- Скрытие контента креативов за платным доступом (все объявления публичны по определению; наши платные тарифы продают удобство — объём API, алерты, командные места — но не доступ к данным).
Как верифицировать наши числа#
- Выберите любого рекламодателя на /advertisers.
- Сравните счётчик креативов на его странице с JSON
/api/v1/advertisers/{slug}. - Для любого указанного канала откройте
t.me/s/{handle}в режиме инкогнито — вы увидите те же спонсорские сообщения, которые мы проиндексировали. - При спорных точках данных свяжитесь с @dumov в Telegram, указав ID креатива.
Лицензирование#
Все экспортированные данные (CSV, JSON, RSS) публикуются по лицензии CC-BY-4.0. Это означает, что вы можете использовать их для любых целей — включая коммерческие — при условии указания tgadsspy.com и ссылки на конкретную страницу креатива или рекламодателя.
Пример цитирования:
Источник: tgadsspy.com, получено 2026-04-20, https://tgadsspy.com/advertisers/{slug}
Журнал изменений#
- 2026-04-20 — первая публикация методологии.
Also available in:
Cite this article
tgadsspy team (2026). Как работает tgadsspy — открытая методология индексирования рекламы Telegram. tgadsspy.com. Retrieved from https://tgadsspy.com/blog/ru-kak-rabotaet-tgadsspy-metodologiya
Licensed CC-BY-4.0 — reuse allowed including commercial, attribution required.