Lo que devuelve
Ve todos los anuncios de Google que un competidor esté ejecutando: Búsqueda, Display y YouTube. Los datos vienen directamente del Centro de Transparencia de Anuncios de Google.
- Nombre del anunciante, ID del anunciante y dominio verificado
- Formato del anuncio: texto (Búsqueda), imagen (Display) o video (YouTube)
- Fecha de primera visualización y última visualización, y el número de días mostrados
- URL de imagen de vista previa, URL de vista previa/render, y un enlace directo al anuncio en el Centro de Transparencia
- Detalles opcionales: cada variación del anuncio y los países en los que se ejecutó, con la última fecha mostrada en cada uno
Usos comunes
Investigación de anuncios de competidores, inspiración creativa y archivos de copia, propuestas de agencias, monitoreo de seguridad de marca y marcas registradas, y seguimiento de cuándo los competidores lanzan o pausan campañas.
Solicitud
POST https://api.pushbuild.com/google-ads-transparency/run con un cuerpo JSON. Envía tu clave en el encabezado X-API-Key.
| Campo | Tipo | Descripción |
|---|---|---|
searchTerms | lista de cadenas | Nombres de marca o empresa, por ejemplo, 'Nike'. Cada uno se empareja con su cuenta de anunciante verificada en Google. |
domains | lista de cadenas | Obtén todos los anuncios que apunten a estos dominios web, por ejemplo, 'shopify.com'. |
advertiserIds | lista de cadenas | IDs de anunciante de Google (comienzan con AR…), tomados de una URL de adstransparency.google.com. |
advertisersPerSearchTerm | entero | ¿Cuántas cuentas de anunciante coincidentes incluir por cada nombre? (las marcas suelen tener varias). Valor predeterminado: 1. |
region | string: , US, GB, CA, AU, DE, FR, IN, BR, JP, ES, IT, NL, MX, SE, PL, IE, NZ, SG, ZA, AE, CH, AT, BE, DK, NO, FI, PT, TR, KR, PH, ID, AR | Solo anuncios mostrados en este país. Valor predeterminado: "". |
format | string: , text, image, video | Solo anuncios de este formato. Valor predeterminado: "". |
dateFrom | string | Solo anuncios mostrados el o después de esta fecha (YYYY-MM-DD). |
dateTo | string | Solo anuncios mostrados el o antes de esta fecha (YYYY-MM-DD). |
maxAdsPerTarget | entero | Detenerse después de este número de anuncios por anunciante o dominio. Valor predeterminado: 100. |
includeDetails | boolean | También obtener cada variación de cada anuncio y la lista de países en los que se ejecutó (una solicitud adicional por anuncio). Valor predeterminado: false. |
maxItems | entero | Número máximo de elementos a devolver (1-500). Predeterminado: 100. |
Ejemplo
curl -X POST https://api.pushbuild.com/google-ads-transparency/run \
-H "X-API-Key: YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"searchTerms": ["Nike"], "maxItems": 20}'Respuesta
{"count": 20, "truncated": false, "seconds": 1.4, "items": [ { ... } ]}Cada llamada devuelve hasta 500 elementos. Los registros que no pasan la validación o no se encuentran se marcan en los elementos y no se cobran.
Precios
Paga solo por los resultados devueltos: $1,20 por 1.000 anuncios raspados. Sin cargo por errores o búsquedas vacías.
Úselo desde Claude, ChatGPT o Cursor
Esta API también es un servidor MCP: https://api.pushbuild.com/mcp/google-ads-transparency. Agrégala a cualquier asistente que soporte servidores MCP remotos, con tu clave en el encabezado X-API-Key. Mismos precios. Configuración para cada aplicación.
Díganos qué necesitan construir.
Preguntas sobre esta API, volúmenes más altos, o una fuente de datos que necesiten que aún no cubrimos.
hello@pushbuild.com