📢 Google Ads Transparency Center Scraper

🔗 View on Apify Store | 🇺🇸 English | 🇧🇷 Português

Extract competitor ad creatives from Google Ads Transparency Center — ads running on Google Search, YouTube, Maps, Play and Shopping. No login or API key required. Uses the public reverse-engineered RPC of adstransparency.google.com.

✨ Features

• Anonymous access — no Google account, no OAuth, no API key
• Search by advertiser name/domain OR direct lookup by AR... advertiser ID
• 18 region filters (US/BR/GB/DE/FR/ES/IT/CA/AU/MX/AR/CL/CO/JP/IN/NL/BE + Anywhere)
• Format filter — TEXT / IMAGE / VIDEO / ALL
• Auto-pagination up to 500 creatives per advertiser
• Rich output — creative ID, headline, body, image URL, video URL, destination URL, regions where ad ran, first/last shown dates
• Polite rate-limit — 400ms inter-page sleep + 500ms inter-advertiser
• NEVER 0 ITEMS guard — fails loud if Google rotated schema instead of silent success

📥 Input

Parameter	Type	Required	Default	Description
mode	enum	Yes	searchTerm	searchTerm = find by name/domain, advertiserId = direct lookup
searchTerm	string	If mode=searchTerm	Nike	Advertiser name, brand or domain
advertiserId	string	If mode=advertiserId	—	Google advertiser ID (format AR...)
region	enum	No	anywhere	ISO country code or anywhere
formatFilter	enum	No	ALL	TEXT / IMAGE / VIDEO / ALL
maxCreatives	int	No	50	Max creatives per advertiser (1-500)
maxAdvertisers	int	No	3	Top-N matching advertisers to fetch (search mode only)

Example input

{
  "mode": "searchTerm",
  "searchTerm": "Nike",
  "region": "US",
  "formatFilter": "VIDEO",
  "maxCreatives": 50,
  "maxAdvertisers": 1
}

📤 Output

{
  "creativeId": "CR123456789",
  "advertiserId": "AR12345678",
  "advertiserName": "Nike, Inc.",
  "advertiserDomain": "nike.com",
  "format": "VIDEO",
  "headline": "Just Do It",
  "body": "Discover the new Air Max collection…",
  "imageUrl": "https://tpc.googlesyndication.com/.../image.jpg",
  "videoUrl": "https://tpc.googlesyndication.com/.../video.mp4",
  "destinationUrl": "https://www.nike.com/...",
  "regions": [
    {"region": "US", "firstShown": "2026-03-01", "lastShown": "2026-05-14", "timesShown": null}
  ],
  "creativeUrl": "https://adstransparency.google.com/advertiser/AR12345678/creative/CR123456789",
  "source": "google-ads-transparency-rpc"
}

💰 Pricing

Pay-per-event: only charged when a real creative is returned. Zero results → zero charge.

🚀 Use cases

• Competitive ad intelligence — see what your competitors are spending on
• Compliance research — track political/issue ads at scale
• Creative analysis — extract winning headline/copy/imagery patterns
• Brand safety — discover ads using your brand keywords
• Affiliate research — find advertiser destination URLs for affiliate matching

⚠️ Common errors

Error	Cause	Fix
[FAIL] No advertisers found	Search term too narrow/typo	Try a broader name OR use region: anywhere
[GOOGLE_RPC] HTTP 429	Rate-limited (rare with built-in sleeps)	Re-run after 60s
[GOOGLE_RPC] HTTP 503	Google maintenance	Re-run later
[FAIL] Zero creatives extracted	Advertiser has no ads in selected region/format	Try region: anywhere + formatFilter: ALL

🔒 No data sent to third parties

All requests go directly to adstransparency.google.com. No proxy, no middleware — your search terms aren't logged anywhere.

📚 Related actors

• Facebook Ad Library Intelligence — Meta Ad Library (FB/IG/Messenger/WhatsApp ads)

🆕 Changelog

• v1.0 (2026-05-15): Initial release. RPC endpoints SearchSuggestions, SearchCreatives, GetCreativeById. Auto-pagination. NEVER 0 ITEMS guard.

---

Português

📢 Google Ads Transparency Center Scraper

Extrai criativos publicitários de competidores do Google Ads Transparency Center — ads rodando em Google Search, YouTube, Maps, Play e Shopping. Sem login, sem API key. Usa o RPC público reverse-engineered de adstransparency.google.com.

✨ Funcionalidades

• Acesso anônimo — sem conta Google, sem OAuth, sem API key
• Busca por nome/domínio do anunciante OU consulta direta pelo ID de anunciante AR...
• 18 filtros de região (US/BR/GB/DE/FR/ES/IT/CA/AU/MX/AR/CL/CO/JP/IN/NL/BE + Anywhere)
• Filtro de formato — TEXT / IMAGE / VIDEO / ALL
• Paginação automática até 500 criativos por anunciante
• Output rico — ID do criativo, headline, body, URL da imagem, URL do vídeo, URL de destino, regiões onde o ad rodou, datas de primeira/última exibição
• Rate-limit educado — pausa de 400ms entre páginas + 500ms entre anunciantes
• Guard NEVER 0 ITEMS — falha de forma explícita se o Google trocar o schema, em vez de sucesso silencioso

📥 Entrada

Parâmetro	Tipo	Obrigatório	Padrão	Descrição
mode	enum	Sim	searchTerm	searchTerm = buscar por nome/domínio, advertiserId = consulta direta
searchTerm	string	Se mode=searchTerm	Nike	Nome do anunciante, marca ou domínio
advertiserId	string	Se mode=advertiserId	—	ID de anunciante do Google (formato AR...)
region	enum	Não	anywhere	Código de país ISO ou anywhere
formatFilter	enum	Não	ALL	TEXT / IMAGE / VIDEO / ALL
maxCreatives	int	Não	50	Máximo de criativos por anunciante (1-500)
maxAdvertisers	int	Não	3	Top-N anunciantes correspondentes a buscar (apenas no modo de busca)

Exemplo de entrada

{
  "mode": "searchTerm",
  "searchTerm": "Nike",
  "region": "US",
  "formatFilter": "VIDEO",
  "maxCreatives": 50,
  "maxAdvertisers": 1
}

📤 Saída

{
  "creativeId": "CR123456789",
  "advertiserId": "AR12345678",
  "advertiserName": "Nike, Inc.",
  "advertiserDomain": "nike.com",
  "format": "VIDEO",
  "headline": "Just Do It",
  "body": "Discover the new Air Max collection…",
  "imageUrl": "https://tpc.googlesyndication.com/.../image.jpg",
  "videoUrl": "https://tpc.googlesyndication.com/.../video.mp4",
  "destinationUrl": "https://www.nike.com/...",
  "regions": [
    {"region": "US", "firstShown": "2026-03-01", "lastShown": "2026-05-14", "timesShown": null}
  ],
  "creativeUrl": "https://adstransparency.google.com/advertiser/AR12345678/creative/CR123456789",
  "source": "google-ads-transparency-rpc"
}

🚀 Casos de Uso

• Inteligência competitiva de ads — veja no que seus concorrentes estão gastando
• Pesquisa de compliance — acompanhar ads políticos/de interesse público em escala
• Análise de criativos — extrair padrões vencedores de headline/copy/imagem
• Brand safety — descobrir ads que usam as palavras-chave da sua marca
• Pesquisa de afiliação — encontrar URLs de destino dos anunciantes para matching de afiliação

⚠️ Erros Comuns

Erro	Causa	Correção
[FAIL] No advertisers found	Termo de busca estreito demais/erro de digitação	Tente um nome mais amplo OU use region: anywhere
[GOOGLE_RPC] HTTP 429	Rate-limited (raro com as pausas internas)	Rode de novo após 60s
[GOOGLE_RPC] HTTP 503	Manutenção do Google	Rode de novo mais tarde
[FAIL] Zero creatives extracted	Anunciante não tem ads na região/formato selecionado	Tente region: anywhere + formatFilter: ALL

💰 Preços

Pay-per-event: você só é cobrado quando um criativo real é retornado. Zero resultados → zero cobrança.

🔒 Nenhum dado enviado a terceiros

Todas as requisições vão diretamente para adstransparency.google.com. Sem proxy, sem middleware — seus termos de busca não são registrados em log em lugar nenhum.

📚 Actors Relacionados

• Facebook Ad Library Intelligence — Meta Ad Library (ads de FB/IG/Messenger/WhatsApp)

🆕 Histórico de Versões

• v1.0 (2026-05-15): Release inicial. Endpoints RPC SearchSuggestions, SearchCreatives, GetCreativeById. Paginação automática. Guard NEVER 0 ITEMS.

Diferencial vs competidores na Apify Store

• Sem auth: 0 fricção de onboarding (concorrentes pedem OAuth ou são pagos)
• Multi-region: 18 países pré-configurados, não só US
• PPE: você paga só pelos criativos retornados, não por run vazio
• Open source compatible: usa o mesmo RPC público que SerpApi / SearchApi cobram $50+/mês

Casos de uso para o mercado BR/LATAM

• Espiar campanhas Google Ads de Magalu, Americanas, Mercado Livre, Magazine Luiza
• Compliance eleitoral — ads políticos no BR/AR/MX
• Pesquisa de afiliação — encontrar advertisers ativos para abordar
• Análise criativa — copiar padrões de headline/copy dos top spenders