Como o tgadsspy funciona — metodologia pública de indexação de anúncios do Telegram
Documentação completa de como indexamos dados de anúncios do Telegram, o que capturamos, o que não capturamos, e como pesquisadores podem verificar nossos números. Metodologia aberta e citável.
Sumário
O Telegram Ads Spy é um projeto OSINT independente que indexa cada campanha publicitária ativa na plataforma oficial Telegram Ads — tanto via gabinete Gram (antigo gabinete TON) quanto via gabinete em euros — em tempo real. Este documento é a referência canônica para pesquisadores, jornalistas e equipes de inteligência competitiva que desejam verificar ou citar nossos dados.
O que indexamos#
- Mensagens patrocinadas da plataforma Telegram Ads — anúncios que o Telegram exibe para qualquer usuário autenticado que visualize um canal público de transmissão.
- Inserções pagas em canais — postagens públicas em canais de transmissão onde o criativo está marcado com um padrão de URL CTA que reconhecemos como inserção paga. A detecção baseia-se em padrões de texto + estrutura de URL CTA, sem lógica proprietária.
- Metadados de canais — número de assinantes, avatar, descrição. Coletados pelo nosso pipeline a partir da resposta de metadados do canal. O idioma principal e o tema não vêm nessa resposta: ambos são rótulos nossos, derivados do título e da descrição.
Nunca indexamos:
- Canais privados, grupos por convite ou qualquer conteúdo atrás de tela de solicitação de entrada.
- Chats privados ou conversas em grupos entre usuários identificáveis.
- Conteúdo protegido por limites de flood do Telegram ou sinalizações DMCA.
Como um canal entra em nosso pool#
Quatro caminhos:
- Seeds em lote — listas curadas manualmente em
scripts/batches/, agrupadas por idioma e nicho. - Descoberta automática — o cron
Telegram Ads Spy-discoverconsulta a pesquisa de canais do Telegram com 202 palavras-chave a cada hora. - Envio do usuário — qualquer pessoa pode colar um handle de canal em /submit e ele entra na fila.
- Extração de CTA — quando um criativo de anúncio linka para
t.me/{handle}, adicionamos{handle}automaticamente ao pool.
Frequência de atualização#
| Componente | Cadência |
|---|---|
| Resolver (atualização de metadados) | A cada 10 minutos |
| Ingest tier S (canais top) | A cada 5 minutos |
| Ingest tier A (canais ativos) | A cada 30 minutos |
| Ingest tier B (canais cauda) | A cada 4 horas |
| Discover (novos seeds de palavras-chave) | Horário |
| Mirror de mídia (link temporário → URL permanente) | A cada 5 minutos |
Dicionário de dados#
Cada criativo de anúncio em nosso índice contém:
id— CUID estável, permanente entre reconstruções.text+title— cópia bruta do criativo como servida pelo Telegram.paymentSource—TON(o gabinete Gram; o valor mantém o nome histórico) ouEUR_ADS_CABINET.niche— um dos 18 buckets do classificador (crypto, gambling, trading, dating, saúde…).geo— código ISO alpha-2, detectado a partir do idioma do criativo + domínio CTA.lang— idioma detectado do criativo (ISO 639-1).firstSeenAt+lastSeenAt— timestamps UTC, estáveis.reachEstimate+spendEstimate— derivados de audiência do canal × CPM de mercado.advertiser— entidade estruturada com{ name, domain, tgUsername, slug }.
Schema completo: /api-docs.
Como estimamos alcance e gasto#
Para cada criativo:
- Somamos a audiência (assinantes) de todos os canais onde observamos o criativo.
- Aplicamos a razão média de visualizações das estatísticas de canais (
avgViews / members). - Multiplicamos pelo benchmark de CPM de mercado atual para o nicho + geo do criativo.
As estimativas de gasto são benchmarks, não contabilidade. Refletem uma taxa de mercado razoável para o volume exibido, não o gasto real do anunciante no cabinet. Use-as para comparação relativa entre anunciantes, não para atribuição exata.
O que nunca faremos#
- Revender acesso ao cabinet do Telegram.
- Reivindicar afiliação com a Telegram FZ-LLC.
- Pagar por entrada em canal privado ou dados privilegiados.
- Esconder conteúdo de criativos por trás de paywall (todos os anúncios são públicos por definição; nossos planos pagos vendem conveniência — volume de API, alertas, assentos de equipe — não acesso a dados).
Como verificar nossos números#
- Escolha qualquer anunciante em /advertisers.
- Compare a contagem de criativos na página deles com o JSON de
/api/v1/advertisers/{slug}. - Para qualquer canal listado, abra
t.me/s/{handle}em um navegador anônimo — você verá as mesmas mensagens patrocinadas que indexamos. - Para pontos de dados contestados, entre em contato com @dumov no Telegram com o ID do criativo.
Licenciamento#
Todos os dados exportados (CSV, JSON, RSS) são disponibilizados sob CC-BY-4.0. Isso significa que você pode usá-los para qualquer finalidade — inclusive comercial — desde que credite o tgadsspy.com e vincule ao criativo ou página do anunciante específico.
Exemplo de citação:
Fonte: tgadsspy.com, acessado em 2026-04-21, https://tgadsspy.com/advertisers/{slug}
Registro de alterações#
Disponível também em:
Citar este artigo
telemetr.com Research (2026). Como o tgadsspy funciona — metodologia pública de indexação de anúncios do Telegram. telemetr.com. Retrieved from: https://telemetr.com/blog/pt-como-tgadsspy-funciona-metodologia-2026
Licenciado CC-BY-4.0 — reutilização permitida incluindo uso comercial, atribuição obrigatória.