~/business/google-ads-scraper

Google Ads Scraper — Search, YouTube y Shopping Ads

Cada anuncio que un competidor publica en Google — Search, YouTube, Shopping, Maps y Play — encontrado por dominio, anunciante o marca, con los días que se mostró cada anuncio, los países a los que llegó y, en la UE, sus impresiones y la segmentación de audiencia.

inteligencia publicitaria TypeScript Global

ejecutar en Apify

proooxy/google-ads-scraper — spec

categoríabusiness / inteligencia publicitaria

lenguajeTypeScript

stackTypeScript

mercadosGlobal

salidaJSON limpio y listo para RAG

características clave

Cada anuncio que un anunciante publica en Google Search, YouTube, Shopping, Maps y Play

Busca anuncios por dominio del sitio web, ID de anunciante, nombre de marca o una URL de página copiada — combinados en una sola ejecución

Primer y último día en que se mostró, y cuántos días lleva activo cada anuncio

El nombre legal que Google verificó para el anunciante, y dónde tiene su sede

Rangos de impresiones en la UE por país y plataforma, y los criterios de audiencia usados — con `details` activado

El titular de un anuncio de texto, los productos de un anuncio de Shopping, el vídeo de YouTube de un anuncio en vídeo, y la página de destino — con `content` activado, cobrado solo cuando se encuentra

Filtros por país, plataforma, formato y fecha; un intervalo como 30 days se ajusta en cada ejecución programada

casos de uso

Monitorear los anuncios de Google de la competencia de forma programada, para que las campañas nuevas aparezcan en la siguiente ejecución
Investigación creativa en todo un mercado: los titulares, productos y vídeos que los anunciantes mantienen activos
Planificación de medios con rangos de impresiones en la UE por país y plataforma
Controles de agencia y de seguridad de marca: qué entidades legales pagan los anuncios que llevan a un sitio web
Generación de leads: qué empresas anuncian en Google, y desde cuándo
Dar a agentes de IA datos de anuncios de la competencia a través del servidor MCP de Apify

parámetros de entrada

Parámetro	Tipo	Obligatorio	Descripción
`domains`	array	opcional	Todo anuncio que lleva a estos sitios web, de cualquier anunciante que publique uno
`advertiserIds`	array	opcional	Todo anuncio de estos anunciantes, por ID o URL de la página del anunciante
`advertiserNames`	array	opcional	El nombre de una empresa o marca; se busca el anunciante con ese nombre que tenga más anuncios
`startUrls`	array	opcional	URLs de página de anunciante, de un solo anuncio o de búsqueda por dominio; los filtros de una URL se aplican a esa URL
`region`	string	opcional	Solo anuncios mostrados en este país, o en cualquier lugar
`platform`	string	opcional	Google Search, YouTube, Google Shopping, Google Maps o Google Play
`adFormat`	string	opcional	Texto, imagen o vídeo
`dateFrom`	string	opcional	Mostrado en o después de una fecha, o un intervalo hacia atrás desde hoy como 30 days
`dateTo`	string	opcional	Mostrado en o antes de una fecha; vacío significa hoy
`maxItems`	number	opcional	Máximo de anuncios almacenados — el tope duro del gasto de la ejecución
`maxAdsPerSearch`	number	opcional	Detiene cada dominio, anunciante, nombre o URL tras este número de anuncios
`includeDetails`	boolean	opcional	Países, rangos de impresiones en la UE y criterios de audiencia, cobrado por anuncio
`includeAdContent`	boolean	opcional	Titulares, productos, vídeos de YouTube y páginas de destino, cobrado solo cuando se encuentra

Ejemplo de salida

 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}

Recortado por brevedad: con details activado, details también lista todos los países en los que se mostró el anuncio, con su primer y último día y, en la UE, las impresiones por plataforma; content también incluye products, youtubeVideoId y youtubeUrl.

Consejos

Busca por dominio, no por el nombre de marca, para lograr cobertura completa. Una búsqueda por dominio devuelve todos los anunciantes cuyos anuncios llevan al sitio — incluidas las entidades regionales y los revendedores que un nombre de marca pasa por alto.
maxItems limita tu gasto. Es el tope duro de los anuncios que una ejecución almacena y cobra; maxAdsPerSearch evita que un anunciante grande lo agote todo.
Usa una fecha relativa para monitorear. Configura dateFrom en 30 days en una ejecución programada y cada ejecución cubrirá el último mes.
Los marcadores de inserción de palabras clave se conservan tal como Google los guarda. Un titular como {KeyWord:Nike Vomero} muestra el texto de respaldo que se usa cuando el término de búsqueda no lo reemplaza.

faq

¿Necesito una cuenta de Google o una clave de API?

No. Los anuncios provienen de la biblioteca pública de anuncios de Google, que cualquiera puede abrir sin iniciar sesión. Ejecutas el Actor en Apify, y cada anuncio es una fila en el dataset.

¿Por qué un nombre de marca encuentra solo un anunciante?

Las marcas suelen anunciarse a través de varias entidades legales — Nike a través de Nike, Inc., Nike Retail BV, y otras. Un nombre encuentra la principal; busca en su lugar el dominio de la marca para obtener todos los anunciantes cuyos anuncios llevan allí.

¿Por qué algunos anuncios de texto no tienen titular?

Google archiva muchos anuncios de texto como una imagen del anuncio. Esos vienen con una imagen de vista previa en lugar de un titular; los titulares y descripciones provienen de los anuncios de texto que Google muestra en vivo.

¿De dónde vienen las cifras de impresiones y audiencia?

Google las publica para los anuncios mostrados en la Unión Europea, bajo la Ley de Servicios Digitales (DSA), y cuenta las impresiones con un retraso de unos tres meses. Fuera de la UE, los detalles indican los países en los que se mostró un anuncio y los días que se mostró allí.