Búsqueda, YouTube y DisplayBusca un anunciante y recopila sus anuncios públicos en Google. Compara formatos, comprueba cuándo aparecieron y observa cómo cambia el mensaje entre mercados.
Prueba estos ejemplos para marketing, crecimiento y análisis de la competencia.
Antes de lanzar un SaaS, busca tres dominios competidores. Revisa sus formatos y mensajes en búsqueda, Display y vídeo. Usa los ejemplos para preparar tus pruebas de canales.
Conserva un inventario creativo de competidores con notas sobre los canales que quieres investigar.
Si estudias un lanzamiento comercial, sigue al anunciante en dos países objetivo. Usa las fechas de primer y último anuncio para ver cuándo aparecieron las creatividades y cómo cambia el texto.
Prepara una comparación por país con enlaces a los anuncios públicos.
Activa los detalles para un grupo pequeño de anunciantes y guarda las URL de variantes. Obtén los ID públicos de YouTube disponibles y revisa los materiales antes de producir tu campaña.
Organiza los materiales por formato para que tu equipo encuentre referencias.
DE LA PRIMERA EJECUCIÓN A UN FLUJO RECURRENTE
{
"domains": ["nike.com"],
"regions": ["GB"],
"platform": "all",
"maxAds": 50,
"fetchAdDetails": false,
"resolveMedia": false,
"proxyConfiguration": {
"useApifyProxy": true
}
}Pégalo en el editor JSON del Actor. Cambia los ejemplos por tus propios objetivos antes de ejecutar.
Consulta el formulario actual en ApifyLos nombres, dominios, IDs y URLs del Centro de Transparencia pueden identificar a un anunciante. Usa un ID si una marca tiene varias entidades legales o la búsqueda por nombre elige la incorrecta.
| Método de búsqueda | Cuándo usarlo | Qué cambia |
|---|---|---|
| Dominios web | Cuándo usarloTienes una lista de competidores. | Qué cambiaDominios verificados como nike.com, más precisos que el nombre de marca. Un dominio sin coincidencia puede buscarse por nombre; revisa el anunciante elegido. |
| Nombre del anunciante o marca | Cuándo usarloQuieres encontrar resultados relevantes antes de elegir objetivos concretos. | Qué cambiaBusca marcas o empresas. El Actor también comprueba su dominio y elige un anunciante. Revisa la identidad y usa un ID AR para fijarla. |
| IDs de anunciantes | Cuándo usarloSabes exactamente qué entidad quieres recopilar. | Qué cambiaIDs AR de las URLs del Centro de Transparencia. Evitan ambigüedades y permiten seguir la misma entidad legal a lo largo del tiempo. |
| URLs de la biblioteca de anuncios | Cuándo usarloYa configuraste la búsqueda en el sitio de origen. | Qué cambiaPega URLs de anunciantes del Centro de Transparencia. Cada URL conserva región y plataforma; los ajustes globales completan los filtros ausentes. |
Conserva anuncios mostrados por última vez desde esta fecha. Se filtran tras recopilarlos porque Google no ofrece filtro de fechas; no garantiza menos solicitudes.
Compara el scraper relacionadoUsa estos nombres exactos en JSON. En el formulario de Apify, introduce cada elemento de las listas por separado y mantén números y booleanos en su tipo correcto.
Default y prefill son distintos. El valor por defecto se aplica si omites un ajuste; el prellenado es un ejemplo introducido en el formulario de Apify. Revisa objetivos y límites antes de cada ejecución. Algunos ajustes no tienen valor por defecto en el esquema. Debes indicar al menos un objetivo admitido.
searchTermsBusca marcas o empresas. El Actor también comprueba su dominio y elige un anunciante. Revisa la identidad y usa un ID AR para fijarla.
domainsDominios verificados como nike.com, más precisos que el nombre de marca. Un dominio sin coincidencia puede buscarse por nombre; revisa el anunciante elegido.
domainUn dominio en lugar de la lista domains. Usa el dominio base; las rutas de la web no limitan los anuncios del anunciante.
advertiserIdsIDs AR de las URLs del Centro de Transparencia. Evitan ambigüedades y permiten seguir la misma entidad legal a lo largo del tiempo.
advertiserIdVersión de advertiserIds para un anunciante. Copia el valor AR de su URL, no el ID de una creatividad.
transparencyUrlsPega URLs de anunciantes del Centro de Transparencia. Cada URL conserva región y plataforma; los ajustes globales completan los filtros ausentes.
transparencyUrlUna URL de anunciante con la misma prioridad que transparencyUrls. Su región prevalece sobre una región global distinta.
regionsVarios países crean trabajos independientes por anunciante y región. Se eliminan duplicados por creative_id. Vacío cubre todas las regiones admitidas; países no compatibles se omiten.
regionUn país, usado solo si regions está vacío. Para comparar mercados, utiliza regions.
platformLimita la plataforma publicitaria de Google. Elige search, youtube, display, shopping, maps, play o all. Los totales pueden solaparse entre plataformas.
all search youtube display shopping maps playminDateConserva anuncios mostrados por última vez desde esta fecha. Se filtran tras recopilarlos porque Google no ofrece filtro de fechas; no garantiza menos solicitudes.
maxDateConserva anuncios cuyo primer día fue esta fecha o anterior. Con minDate selecciona difusión solapada con tu periodo. Usa YYYY-MM-DD.
proxyConfigurationSe recomienda Apify Proxy; normalmente basta datacenter. Este Actor no requiere residencial. Una configuración rechazada puede pasar al proxy predeterminado de la cuenta.
maxConcurrencyDe 1 a 10 trabajos paralelos por anunciante y región. Ayuda con varios anunciantes o regiones; un solo anunciante en una región se pagina de forma secuencial.
maxAdsLímite de anuncios únicos de toda la ejecución, incluidos todos los objetivos y mercados. Empieza con 50. Si lo dejas vacío, una búsqueda amplia puede crecer mucho.
maxPagesLímite de páginas por trabajo anunciante-región. Cada página contiene hasta pageSize anuncios, máximo 100. Es un límite de prueba, no un total global.
fetchAdDetailsAñade desglose por región, fechas regionales y variantes. Requiere una solicitud extra por anuncio; actívalo solo si necesitas esos campos.
resolveMediaRealiza solicitudes extra para obtener IDs de vídeos públicos de YouTube. No puede crear una URL pública para vídeos de display que no la tengan.
pageSizeDe 1 a 100 anuncios por solicitud. Los valores mayores se ajustan a 100 porque Google los rechaza. Mantén 100 salvo depuración.
delayMsPausa entre solicitudes de páginas, en milisegundos. Auméntala si la fuente limita solicitudes; reducirla no elimina la latencia ni sus límites.
rawDevuelve la estructura de la fuente en lugar de la presentación normalizada. Mantén false para columnas consistentes y usa true para depuración o transformaciones propias.
proxyRotationsReintenta solicitudes rechazadas con una sesión proxy nueva. Más intentos pueden superar bloqueos temporales, pero añaden tiempo y tráfico. Mantén el valor predeterminado salvo que el registro indique un motivo para cambiarlo.
resumeGuarda el progreso aproximadamente cada 30 segundos para continuar tras un reinicio o migración. Déjalo activado.
continueFromLastRunContinúa el trabajo pendiente de la ejecución anterior con la misma entrada. Los resultados anteriores quedan en su dataset. Usa false para una colección nueva o periódica.
impersonateIdentidad de navegador utilizada en las solicitudes. Conserva el valor predeterminado salvo que investigues bloqueos inmediatos. Cambia la huella de la solicitud, no los datos solicitados.
proxySessionIdFija una sesión proxy para depuración. Déjalo vacío en uso normal. Los trabajos paralelos necesitan sesiones propias y pueden ignorar esta sesión fija.
Esta referencia sigue los campos del Actor. Revisa el formulario actual antes de cambiar un flujo de producción. Consulta el formulario actual en Apify.
Cada ejemplo es una ejecución independiente. Empieza con poco, revisa los resultados y amplía después. Adapta objetivos, países y fechas a tu pregunta.
Dos dominios y dos regiones generan cuatro búsquedas anunciante-región. El límite de 150 se aplica al dataset combinado sin duplicados. No reserva una muestra igual para cada marca o país.
{
"domains": ["nike.com", "adidas.com"],
"regions": ["GB", "FR"],
"maxAds": 150,
"fetchAdDetails": false,
"proxyConfiguration": {
"useApifyProxy": true
}
}Filtra por YouTube y activa resolveMedia para intentar obtener IDs y URLs de vídeo. Revisa los campos antes de dar enlaces a Claude; algunos anuncios no tienen vídeo accesible directamente.
{
"domains": ["nike.com"],
"regions": ["GB"],
"platform": "youtube",
"maxAds": 50,
"resolveMedia": true,
"proxyConfiguration": {
"useApifyProxy": true
}
}Añade detalles y un periodo de difusión para Alemania. Las fechas se comprueban después de recuperar anuncios, así que un periodo corto no garantiza bajo coste. Cambia las fechas y empieza con un límite pequeño.
{
"domains": ["nike.com"],
"regions": ["DE"],
"minDate": "2026-09-01",
"maxDate": "2026-09-30",
"maxAds": 50,
"fetchAdDetails": true,
"proxyConfiguration": {
"useApifyProxy": true
}
}Guarda IDs de anunciante y anuncio con región, plataforma y fecha. Los ajustes de detalle y medios enriquecen registros, no crean un dataset de rendimiento. Usa Sheets para revisar anuncios o BigQuery y dbt para historial sin duplicados. La fuente no ofrece gasto, ROAS ni conversiones.
resume protege la ejecución actual si Apify la reinicia. continueFromLastRun continúa una anterior con la misma configuración; sus registros siguen en el dataset anterior. Une ambos datasets y aumenta un límite ya alcanzado. Empieza de nuevo si quieres ver qué ha cambiado hoy.
Guarda una configuración anterior como input.json. Define APIFY_TOKEN con tu token de Apify en la terminal y envía el archivo como cuerpo de la solicitud.
curl --fail-with-body --request POST \
--url "https://api.apify.com/v2/actors/jmlp~google-ads-transparency-center-scraper/runs" \
--header "Authorization: Bearer $APIFY_TOKEN" \
--header "Content-Type: application/json" \
--data-binary @input.jsonLa respuesta contiene un ID de ejecución y defaultDatasetId, no resultados finales. Espera a que termine con éxito, define DATASET_ID con ese ID y recupera los elementos. Para datasets grandes, usa limit y offset para paginar.
curl --fail-with-body \
--url "https://api.apify.com/v2/datasets/$DATASET_ID/items?format=json" \
--header "Authorization: Bearer $APIFY_TOKEN"Referencia de la API de ejecución y exportación de Apify
Opciones de exportación del dataset
Cambia un ajuste cada vez, mantén un límite bajo y revisa el resumen antes de ampliar.
IDs AR de las URLs del Centro de Transparencia. Evitan ambigüedades y permiten seguir la misma entidad legal a lo largo del tiempo.
Realiza solicitudes extra para obtener IDs de vídeos públicos de YouTube. No puede crear una URL pública para vídeos de display que no la tengan.
De 1 a 10 trabajos paralelos por anunciante y región. Ayuda con varios anunciantes o regiones; un solo anunciante en una región se pagina de forma secuencial.
El éxito indica que el Actor terminó, no que la fuente devolviera datos. Revisa SUMMARY.inputProblem, SUMMARY.problem y el registro: pueden faltar objetivos, haber filtros inválidos o solicitudes rechazadas. Prueba un objetivo conocido con menos filtros.
Revisa límites globales, por búsqueda y por página, cobertura y duplicados. Varias búsquedas pueden encontrar el mismo registro. El total de la fuente puede incluir datos no disponibles públicamente. Revisa los trabajos pendientes antes de dar el dataset por completo.
Reúne creative_id, advertiser_name, format, first_shown, last_shown y preview_url en una hoja. Añade una columna de tema de campaña para las notas del equipo.
Leer la guíaPide a Claude que compare formatos y fechas de publicación de pocos anunciantes. Solicita enlaces a las fuentes y separa sus interpretaciones de los datos observados.
Leer la guíaCompara formatos por anunciante y muestra cuándo aparecen nuevos ID creativos. Si recopilas regiones, aplana ese array antes de informar por mercado.
Leer la guíaElimina duplicados con creative_id y conserva cada observación fechada. Guarda regiones y variantes en tablas secundarias para que las uniones no inflen el número de creatividades.
Leer la guía
Comprueba el esquema de jmlp/google-ads-transparency-center-scraper y recopila como máximo 50 registros de nike.com en GB. Resume formatos y fechas disponibles, cita transparency_url e identifica preguntas para investigar. No estimes gasto ni ROAS.Conserva la hora de recopilación y los ID originales. Los necesitarás para comprobar el origen de un resultado o compararlo con otra ejecución.
Los datos de transparencia de Google no incluyen conversiones ni ROAS de competidores. Los filtros de fecha se aplican después de recopilar: un periodo corto puede no acortar el rastreo. Los detalles y la resolución de vídeos añaden solicitudes; actívalos cuando los necesites.
Puede recopilar registros de búsqueda, YouTube, Display, Shopping y Maps, según la plataforma elegida y los datos públicos disponibles.
No necesariamente. El endpoint de origen no permite filtrar por fecha: el scraper recopila páginas y filtra después. Limita la ejecución con maxAds y los controles de detalles opcionales.
Fuente y detalles actuales del producto: Actor Google Ads Transparency de JMLP en Apify.
Facebook & Instagram01Mira qué anuncian tus competidores.
Guarda los anuncios de tus competidores en un solo lugar. Compara textos, ofertas y fechas antes de planificar tu próxima campaña.
Biblioteca de contenido comercial02Encuentra ideas de vídeo que merezca la pena probar.
Recopila anuncios de TikTok de 32 mercados de la UE/EEE, Reino Unido y Suiza. Guarda enlaces y fechas de difusión, y revisa los anuncios de los que quieras aprender.
Cuéntame qué necesitas recopilar o entender. Puedo ayudarte con un scraper a medida, un pipeline o el análisis.
Hablemos de tu proyecto