API de Google Ads Transparency Center
El Centro de transparencia de anuncios de Google muestra anuncios de anunciantes verificados en la Búsqueda de Google, YouTube, Google Play, Maps y Shopping. ads lista hasta 100 anuncios de un anunciante, buscado por dominio o ID de anunciante.
Pasa un dominio como lululemon.com o un ID de anunciante que empiece por AR en advertiser. Los anuncios salen aproximadamente del más reciente al más antiguo. Las filas no traen el texto del anuncio, el gasto ni las impresiones; abre url o image_url para ver la creatividad. advertiser_name es el nombre verificado, que puede ser una filial o una agencia. Solo aparecen anunciantes que completaron la verificación de Google.
Disponibilidad de la plataforma
- Salud 24 h
- Normal
Últimos 30 días
Funciones disponibles
Cada acción de Google Ads Transparency Center, qué hace, su precio y su salud en las últimas 24 horas. Abre una acción para ver sus parámetros, campos de respuesta y ejemplos de código.
| Capacidad | Qué hace | Por 1.000 | Salud en 24 horas |
|---|---|---|---|
Listar los anuncios de una empresa en Googleads | Envía advertiser con un dominio o ID de anunciante para obtener hasta 100 filas con ad_id, advertiser_id, advertiser_name, domain, format, first_shown_at, last_shown_at, image_url, url y advertiser_ads_estimate. | $0.68 por 1.000 solicitudes | Normal |
Abre una capacidad para ver sus parámetros, campos de respuesta, ejemplos de código y prueba.
¿Qué acepta cada acción de Google Ads Transparency Center?
Cada respuesta enlaza una acción ejecutable con sus entradas reales. El significado y los valores permitidos pertenecen a esa acción; un nombre parecido no conserva automáticamente el mismo sentido en otra plataforma.
Las fuentes oficiales se enlazan solo para precisar el término de la plataforma indicado a su lado. No implican autorización ni respaldo y no añaden a EveryInfra funciones del sitio oficial.
| Acción | Obligatorios | Opcionales | Entrega | Límite | Por 1.000 | Campos de respuesta |
|---|---|---|---|---|---|---|
adsListar los anuncios de una empresa en Google Envía | advertiser | country, end_date, format, start_date, surface | Entrega síncrona | El catálogo declara defaultLimit = 100 y maxLimit = 100 para el límite de esta acción. Según la acción, la unidad puede aplicarse a una página, a cada elemento padre o a otra unidad propia de la acción; no es necesariamente el total final de filas de toda la solicitud. | $0.68 por 1.000 solicitudes | rank · ad_id · advertiser_id · advertiser_name · domain · format · first_shown_at · last_shown_at · image_url · url · advertiser_ads_estimate · platform |
¿Qué significan los parámetros de Google Ads Transparency Center ads?
Envía advertiser con un dominio o ID de anunciante para obtener hasta 100 filas con ad_id, advertiser_id, advertiser_name, domain, format, first_shown_at, last_shown_at, image_url, url y advertiser_ads_estimate. Filtra con country, format, surface, start_date y end_date. La llamada cuesta lo mismo con 1 que con 100 filas.
advertiserObligatorio- De quién listar anuncios: un dominio como
nike.como un ID de anunciante que empiece por AR, comoAR01614014350098432001. También sirve un enlace de anunciante del Centro de transparencia.Ayuda de My Ad Center: verificación de anunciantes y Centro de transparencia de anuncios — La ayuda de Google explica que los anunciantes deben verificar su identidad con documentación legal y que el Centro de transparencia de anuncios permite buscar por nombre de anunciante o sitio web y filtrar por región y fecha. La fuente respalda que se busque por dominio o anunciante y se filtre por país y fechas; los parámetros de esta API los define EveryInfra y la fuente no garantiza los resultados. · Consultada countryOpcional- Código de país de dos letras, como
usogb, para quedarse con los anuncios mostrados en ese país. Sin él, todas las regiones. end_dateOpcional- Solo anuncios mostrados por primera vez en esta fecha o antes, AAAA-MM-DD; no anterior a
start_date. formatOpcional- Solo un formato de anuncio:
text,imageovideo.Valores permitidos:imagetextvideo start_dateOpcional- Solo anuncios mostrados por primera vez en esta fecha o después, AAAA-MM-DD.
surfaceOpcional- Solo anuncios mostrados en un producto de Google:
search,youtube,play,mapsoshopping.
Cómo usar la API de Google Ads Transparency Center
- 01Consulta el catálogo público y elige una acción de la plataforma.
- 02Envía los parámetros platform y action, junto con los campos obligatorios, a POST /api/v1/social.
- 03Procesa el resultado síncrono o consulta el identificador de trabajo cuando la acción se ejecute de forma asíncrona.
- 04Guarda los campos de la respuesta estructurada que necesita tu aplicación.
curl -X POST https://api.everyinfra.com/api/v1/social \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"platform":"google_ads_transparency","action":"ads","params":{"advertiser":"<advertiser>"}}'
Preguntas sobre la API de Google Ads Transparency Center
¿Cómo llamo a la API de Google Ads Transparency Center?
Envía POST /api/v1/social con platform igual a google_ads_transparency, elige uno de los identificadores de acción indicados e incluye sus parámetros obligatorios.
¿Qué devuelve la API de Google Ads Transparency Center?
Devuelve JSON estructurado. Por ejemplo, el esquema de ads incluye rank, ad_id, advertiser_id y advertiser_name. Cada acción tiene su propia lista de campos; que un campo esté declarado no garantiza que todos los registros tengan un valor.
¿Qué matiz de la documentación oficial conviene conservar al usar datos de Google Ads Transparency Center?
La ayuda de Google explica que los anunciantes deben verificar su identidad con documentación legal y que el Centro de transparencia de anuncios permite buscar por nombre de anunciante o sitio web y filtrar por región y fecha. La fuente respalda que se busque por dominio o anunciante y se filtre por país y fechas; los parámetros de esta API los define EveryInfra y la fuente no garantiza los resultados.
¿Qué parámetros son obligatorios?
Depende de la acción. ads requiere advertiser.
¿Las acciones de Google Ads Transparency Center responden de inmediato?
Las acciones marcadas como asíncronas devuelven un identificador de trabajo que se consulta por sondeo. Cualquier otra acción también puede ejecutarse de forma asíncrona: añade "mode": "async" al cuerpo de la solicitud para recibir el identificador de inmediato, útil para tareas lentas o límites altos.