~/business/google-ads-scraper

Google Ads Scraper — Search, YouTube e Shopping Ads

Todo anúncio que um concorrente veicula no Google — Search, YouTube, Shopping, Maps e Play — encontrado por domínio, anunciante ou marca, com os dias em que cada anúncio rodou, os países que alcançou e, na UE, suas impressões e a segmentação de público.

inteligência publicitária TypeScript Global

executar no Apify

proooxy/google-ads-scraper — especificações

categoriabusiness / inteligência publicitária

linguagemTypeScript

stackTypeScript

mercadosGlobal

saídaJSON limpo e pronto para RAG

principais recursos

Todo anúncio que um anunciante veicula no Google Search, YouTube, Shopping, Maps e Play

Busque anúncios por domínio do site, ID do anunciante, nome da marca, ou uma URL de página copiada — combinados em uma única execução

Primeiro e último dia em que rodou, e quantos dias cada anúncio já rodou

O nome legal que o Google verificou para o anunciante, e onde ele está sediado

Faixas de impressões na UE por país e plataforma, e os critérios de público usados — com `details` ativado

O título de um anúncio de texto, os produtos de um anúncio do Shopping, o vídeo do YouTube de um anúncio em vídeo, e a página de destino — com `content` ativado, cobrado somente quando encontrado

Filtros por país, plataforma, formato e data; um intervalo como 30 days se ajusta a cada execução agendada

casos de uso

Monitorar os anúncios do Google dos concorrentes em uma agenda, para que novas campanhas apareçam na próxima execução
Pesquisa de criativos em todo um mercado: os títulos, produtos e vídeos que os anunciantes mantêm no ar
Planejamento de mídia com faixas de impressões na UE por país e plataforma
Verificações de agência e de segurança de marca: quais entidades legais pagam por anúncios que levam a um site
Geração de leads: quais empresas anunciam no Google, e desde quando
Dar a agentes de IA dados de anúncios da concorrência através do servidor MCP da Apify

parâmetros de entrada

Parâmetro	Tipo	Obrigatório	Descrição
`domains`	array	opcional	Todo anúncio que leva a esses sites, de qualquer anunciante que veicule um
`advertiserIds`	array	opcional	Todo anúncio desses anunciantes, por ID ou URL da página do anunciante
`advertiserNames`	array	opcional	Um nome de empresa ou marca; é buscado o anunciante com esse nome que tem mais anúncios
`startUrls`	array	opcional	URLs de página de anunciante, de um único anúncio, ou de busca por domínio; filtros em uma URL se aplicam a essa URL
`region`	string	opcional	Somente anúncios exibidos neste país, ou em qualquer lugar
`platform`	string	opcional	Google Search, YouTube, Google Shopping, Google Maps ou Google Play
`adFormat`	string	opcional	Texto, imagem ou vídeo
`dateFrom`	string	opcional	Exibido em ou após uma data, ou um intervalo anterior a partir de hoje como 30 days
`dateTo`	string	opcional	Exibido em ou antes de uma data; vazio significa hoje
`maxItems`	number	opcional	Máximo de anúncios armazenados — o teto rígido do gasto da execução
`maxAdsPerSearch`	number	opcional	Interrompe cada domínio, anunciante, nome ou URL após este número de anúncios
`includeDetails`	boolean	opcional	Países, faixas de impressões na UE e critérios de público, cobrado por anúncio
`includeAdContent`	boolean	opcional	Títulos, produtos, vídeos do YouTube e páginas de destino, cobrado somente quando encontrado

Exemplo de saída

 1{
 2  "creativeId": "CR04380650295827365889",
 3  "adUrl": "https://adstransparency.google.com/advertiser/AR18378488041124659201/creative/CR04380650295827365889?region=NL",
 4  "advertiserId": "AR18378488041124659201",
 5  "advertiserName": "Nike Retail BV",
 6  "advertiserLegalName": "Nike Retail BV",
 7  "advertiserCountry": "NL",
 8  "advertiserVerified": true,
 9  "format": "TEXT",
10  "firstShown": "2025-10-22T15:05:47.575Z",
11  "lastShown": "2026-09-28T13:07:21.342Z",
12  "daysShown": 342,
13  "region": "NL",
14  "queryType": "advertiserId",
15  "details": {
16    "euImpressions": { "min": 250000, "max": 300000 },
17    "audience": {
18      "demographicInfo": { "included": true, "excluded": false },
19      "geographicLocations": { "included": true, "excluded": false },
20      "contextualSignals": { "included": true, "excluded": false }
21    }
22  },
23  "content": {
24    "headline": "{KeyWord:Nike Vomero}",
25    "description": "Découvre {Keyword:chaussures Nike} sur Nike.com. Commande sur le site officiel Nike.",
26    "landingUrl": null
27  }
28}

Reduzido por brevidade: com details ativado, details também lista todos os países em que o anúncio rodou, com seu primeiro e último dia e, na UE, impressões por plataforma; content também traz products, youtubeVideoId e youtubeUrl.

Dicas

Busque pelo domínio, não pelo nome da marca, para cobertura completa. Uma busca por domínio retorna todos os anunciantes cujos anúncios levam ao site — incluindo as entidades regionais e revendedores que um nome de marca não pega.
maxItems limita seu gasto. É o teto rígido dos anúncios que uma execução armazena e cobra; maxAdsPerSearch impede que um grande anunciante consuma tudo sozinho.
Use uma data relativa para monitoramento. Defina dateFrom como 30 days em uma execução agendada e cada execução cobrirá o último mês.
Os placeholders de inserção de palavra-chave são mantidos como o Google os armazena. Um título como {KeyWord:Nike Vomero} mostra o texto substituto usado quando o termo de busca não o substitui.

faq

Preciso de uma conta do Google ou de uma chave de API?

Não. Os anúncios vêm da biblioteca pública de anúncios do Google, que qualquer pessoa pode abrir sem fazer login. Você executa o Actor na Apify, e cada anúncio é uma linha no dataset.

Por que um nome de marca encontra apenas um anunciante?

Marcas costumam anunciar através de várias entidades legais — a Nike através da Nike, Inc., da Nike Retail BV, e outras. Um nome encontra a principal; busque em vez disso o domínio da marca para obter todos os anunciantes cujos anúncios levam até ali.

Por que alguns anúncios de texto não têm título?

O Google arquiva muitos anúncios de texto como uma imagem do anúncio. Esses vêm com uma imagem de pré-visualização em vez de um título; títulos e descrições vêm dos anúncios de texto que o Google exibe ao vivo.

De onde vêm os números de impressões e público?

O Google os publica para anúncios exibidos na União Europeia, sob a Lei de Serviços Digitais (DSA), e conta as impressões com um atraso de cerca de três meses. Fora da UE, os detalhes informam os países em que um anúncio rodou e os dias em que rodou ali.