Як працює tgadsspy — публічна методологія індексування реклами Telegram

Telegram Ads Spy — незалежний OSINT-проект, що індексує кожну рекламну кампанію на офіційній платформі Telegram Ads у реальному часі — як оплачені через Gram-кабінет (колишній TON-кабінет), так і через євро-кабінет. Цей документ є канонічним довідником для дослідників, журналістів і команд конкурентної розвідки, які хочуть перевірити або процитувати наші дані.

Що ми індексуємо#

1. Спонсоровані повідомлення платформи Telegram Ads — оголошення, які офіційний API Telegram надає будь-якому автентифікованому користувачу, що переглядає публічний канал мовлення.
2. Платні розміщення в каналах — пости в каналах мовлення, де креатив позначено патерном URL CTA, який ми розпізнаємо як платне розміщення. Виявлення базується на текстових патернах + структурі URL CTA, а не на пропрієтарній логіці.
3. Метадані каналу — кількість підписників, аватар, опис. Наш конвеєр отримує їх від Telegram у відповіді на запит про канал. Основної мови й теми в цій відповіді немає: і те, і те — наші власні ярлики, виведені із заголовка та опису.

Ми ніколи не індексуємо:

• Приватні канали, групи лише за запрошенням або будь-що за екраном запиту на вступ.
• Приватні чати або групові розмови між ідентифікованими користувачами.
• Контент, захищений flood-лімітами Telegram або позначками DMCA.

Як канал потрапляє до нашого пулу#

Чотири шляхи:

1. Пакетні сіди — вручну відібрані списки у scripts/batches/, згруповані за мовою та нішею.
2. Автовиявлення — cron Telegram Ads Spy-discover щогодини проганяє пошуком каналів Telegram 202 ключові слова-сіди.
3. Надсилання користувачем — будь-хто може вставити хендл каналу на /submit і він потрапить до черги.
4. Видобування CTA — коли рекламний креатив посилається на t.me/{handle}, ми автоматично додаємо {handle} до пулу.

Частота оновлення#

Словник даних#

Кожен рекламний креатив в нашому індексі містить:

• id — стабільний CUID, постійний між перебудовами.
• text + title — сирий текст креативу так, як його подає Telegram.
• paymentSource — TON або EUR_ADS_CABINET (значення TON історичне: так позначаються оголошення Gram-кабінету).
• niche — один з 18 класифікаційних бакетів (крипто, азартні ігри, трейдинг, знайомства, здоров'я…).
• geo — код ISO альфа-2, визначений за мовою креативу + доменом CTA.
• lang — виявлена мова креативу (ISO 639-1).
• firstSeenAt + lastSeenAt — мітки часу UTC, стабільні.
• reachEstimate + spendEstimate — розраховані з аудиторії каналу × ринковий CPM.
• advertiser — структурована сутність з { name, domain, tgUsername, slug }.

Повна схема: /api-docs.

Як ми оцінюємо охоплення та витрати#

Для кожного креативу:

1. Підсумовуємо аудиторію (підписників) усіх каналів, де ми спостерігали цей креатив.
2. Застосовуємо середній коефіцієнт переглядів зі статистики наших каналів (avgViews / members).
3. Множимо на поточний ринковий бенчмарк CPM для ніші + geo креативу.

Оцінки витрат є бенчмарками, а не бухгалтерією. Вони відображають розумну ринкову ставку для відображеного обсягу, а не фактичні витрати рекламодавця в кабінеті. Використовуйте їх для відносного порівняння між рекламодавцями, а не для точного атрибутування.

Що ми ніколи не робитимемо#

• Перепродавати доступ до кабінету Telegram.
• Заявляти про афіліацію з Telegram FZ-LLC.
• Платити за доступ до приватних каналів або інсайдерських даних.
• Ховати вміст креативів за пейволом (всі оголошення за визначенням є публічними; наші платні рівні продають зручність — обсяг API, сповіщення, командні місця — а не доступ до даних).

Як перевірити наші цифри#

1. Оберіть будь-якого рекламодавця на /advertisers.
2. Порівняйте кількість креативів на їхній сторінці з JSON /api/v1/advertisers/{slug}.
3. Для будь-якого перерахованого каналу відкрийте t.me/s/{handle} в браузері в режимі інкогніто — ви побачите ті самі спонсоровані повідомлення, які ми проіндексували.
4. Для спірних точок даних зв'яжіться з @dumov у Telegram, вказавши ID креативу.

Ліцензія#

Всі експортовані дані (CSV, JSON, RSS) випускаються під CC-BY-4.0. Ви можете використовувати їх для будь-яких цілей — включаючи комерційні — за умови зазначення tgadsspy.com та посилання на конкретну сторінку креативу або рекламодавця.

Приклад цитування:

Джерело: tgadsspy.com, отримано 2026-04-22, https://tgadsspy.com/advertisers/{slug}

Журнал змін#

• 2026-04-22 — перша публікація методології українською мовою.
• 2026-09-23 — термінологія: TON-кабінет → Gram-кабінет (монета мережі TON з 15.06.2026 називається Gram, анонс).