Como tgadsspy funciona: Deep Dive técnico no Classificador e Pipeline de Ingestão

Objetivo e Audiência#

Este documento é um deep dive técnico no funcionamento do Telegram Ads Spy: recolha, classificação e disponibilização de dados de publicidade do Telegram. Complementa a visão geral em /about com detalhes de nível de implementação.

Audiência primária: developers que constroem sobre a API pública; investigadores que precisam compreender a proveniência dos dados para citação; equipas de compliance que avaliam a metodologia OSINT do sistema.

1. Fonte de Dados#

Todos os dados de publicidade no Telegram Ads Spy provêm de uma única fonte: o nosso pipeline automatizado de coleta. Essa camada de coleta funciona sobre a API do Telegram e devolve dados estruturados.

O que coletamos#

• Mensagens patrocinadas nos canais monitorados: texto, botão CTA e seu link, mídia e destino do anunciante.
• Metadados do canal: título, username, descrição, número de membros e avatar.
• Pesquisa de canais, usada para a descoberta de novos canais e quando um usuário envia um link t.me.
• Recomendações de canais semelhantes do Telegram, usadas para ampliar o pool de canais.

2. Classificação de Nicho#

Cada AdCreative recebe um nicho de ~25 categorias: sports-betting, crypto-exchange, defi, forex-trading, p2p-crypto, gambling, edtech, real-estate e outros. A classificação é feita em lib/niche.ts via regras regex sobre título + texto + CTA URL.

Arquitetura: sistema de pesos — correspondências fortes (ex: "1xBet" → sports-betting) atribuem 3–5 pontos; fracas, 1–2. Ganha o nicho com maior pontuação total.

3. Classificação Geo#

Pipeline de 3 etapas:

1. Língua do canal → mapeamento langToGeo() (ru → RU/UA/KZ/BY, ar → SA/EG/AE/…)
2. CTA URL → extração de TLD (.de → DE, .com.br → BR)
3. Texto do criativo → padrões de moeda, nomes de cidades, referências regulatórias

4. Mirror de Mídia#

Os links temporários originais da mídia expiram em 1 hora. Mirror-cron (Telegram Ads Spy-media-mirror, a cada 5 min):

1. Faz download do ficheiro de mídia
2. Calcula hash SHA256
3. Armazena em /var/www/tgadsspy-media/<prefixo>/<hash>.<ext>
4. Atualiza AdCreative.mediaUrl → URL permanente /m/<hash>.<ext>

Referência de Metodologia#

Documentação completa: tgadsspy.com · API: /api/v1/ads. CC-BY-4.0.

Dados ao vivo via Telegram Ads Spy

O Telegram Ads Spy indexa todos os anúncios patrocinados do Telegram em tempo real. Os criativos descobertos podem ser explorados em tgadsspy.com/ads ou exportados via API aberta /api/v1/ads.

Acesso a dados: tgadsspy.com · CC-BY-4.0.