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

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

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

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

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

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

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

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

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

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

Компонент	Кадентність
Resolver (оновлення метаданих)	Кожні 10 хвилин
Ingest рівень S (топ-канали)	Кожні 5 хвилин
Ingest рівень A (активні канали)	Кожні 30 хвилин
Ingest рівень B (хвостові канали)	Кожні 4 години
Discover (нові ключові слова)	Щогодини
Дзеркало медіа (gramesh → постійний URL)	Кожні 5 хвилин

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

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

• id — стабільний CUID, постійний між перебудовами.
• text + title — сирий текст креативу так, як його подає Telegram.
• paymentSource — TON або EUR_ADS_CABINET.
• 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 — перша публікація методології українською мовою.

tgadsspy research (2026). Як працює tgadsspy — публічна методологія індексування реклами Telegram. tgadsspy.com. Retrieved from https://tgadsspy.com/blog/uk-yak-pratsiuie-tgadsspy-metodolohiia-2026