Google Ad Library API
Descubra anunciantes públicos, obtenga las creatividades de una empresa o consulte por URL una creatividad conocida del Transparency Center para investigación y revisión.
API de la Google Ad Library disponibles
Use Advertiser Search para encontrar candidatos, Company Ads para obtener conjuntos acotados de creatividades y Ad Details para resolver la URL exacta de una creatividad pública.
¿Qué datos de transparencia publicitaria de Google se pueden obtener?
SocQ normaliza los campos públicos disponibles del Transparency Center y conserva como null o vacíos los valores de la fuente que no están disponibles.
Descubrimiento de anunciantes
Encuentre por consulta identidades de anunciantes candidatos, sitios web, logotipos, regiones y los campos disponibles de cantidad de anuncios.
Contexto de creatividades y destinos
Obtenga el texto, las referencias de anunciantes, los formatos, los recursos multimedia y los destinos de las páginas de aterrizaje que estén disponibles.
Contexto público de entrega
Conserve las fechas, los países, las superficies de Google y los valores de impresiones normalizados de forma segura que estén disponibles.
SocQ y los productos de Google Ads
SocQ normaliza los registros públicos de transparencia compatibles. Los productos de Google Ads siguen siendo la opción adecuada para las operaciones autorizadas de cuentas y campañas.
| Funcionalidad | SocQ | Productos de Google Ads |
|---|---|---|
| Uso principal | Descubrir y normalizar registros públicos de transparencia | Administrar cuentas publicitarias y campañas autorizadas |
| Entradas | Consulta, identificador de empresa y filtros, o URL exacta de una creatividad | Entradas de cuenta, campaña o informes propias de cada producto |
| Autenticación | Clave de API de SocQ | Credenciales y autorización de Google propias de cada producto |
| Formato de respuesta | Registros públicos normalizados de anunciantes y anuncios | Respuesta nativa propia de cada producto |
Cómo funcionan las API de la Google Ad Library
Los tres endpoints usan el ciclo asíncrono de SocQ de envío, consulta y lectura de resultados.
1. Elegir un endpoint
Envíe una consulta a Advertiser Search, un dominio o un ID de anunciante a Company Ads, o la URL de una creatividad a Ad Details.
2. Enviar y dar seguimiento a la tarea
Envíe la solicitud por POST, guarde el task_id y consulte /v1/tasks/{task_id} hasta que el procesamiento termine.
3. Leer los resultados normalizados
Procese data.results.items; Company Ads respeta el tope solicitado, mientras que Ad Details devuelve como máximo un elemento.
Autentíquese con una clave de API de SocQ e indique el dominio de la empresa o el ID del anunciante. El tope de resultados predeterminado es 40.
curl -X POST "https://api.socq.ai/v1/google-ad-library/company-ads" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"domain":"lululemon.com","results_limit":40}'
# Also available:
# POST /v1/google-ad-library/advertiser-search
# POST /v1/google-ad-library/ad
# Poll GET /v1/tasks/{task_id}Casos de uso frecuentes de la Google Ad Library API
Descubrimiento de anunciantes
Convierta la consulta de una marca o un sitio web en anunciantes públicos candidatos antes de obtener los anuncios.
Investigación de creatividades por empresa
Obtenga conjuntos acotados de creatividades públicas con filtros opcionales de tema, región, fecha, superficie y formato.
Enriquecimiento de creatividades seleccionadas
Complete el registro de una creatividad conocida con los campos de anunciante, texto, contenido multimedia, destino y entrega.
Límites y política de datos públicos
Los resultados dependen de la visibilidad pública actual de la fuente y no ofrecen datos privados de cuentas de Google Ads.
- Advertiser Search requiere una consulta y acepta una región opcional; no tiene el parámetro results_limit.
- Company Ads requiere domain o advertiser_id y acepta results_limit en múltiplos de 40, de 40 a 2,000.
- Ad Details requiere una URL de adstransparency.google.com cuya ruta contenga /creative/ y devuelve como máximo un elemento.
- Los registros públicos pueden estar incompletos y no exponen presupuestos privados, clics, conversiones, pujas, audiencias ni retorno de la inversión publicitaria.
Preguntas frecuentes sobre la Google Ad Library API
¿Qué endpoint debo usar primero?
Use Advertiser Search cuando solo conozca una marca o un sitio web, Company Ads cuando tenga un dominio o un ID de anunciante, y Ad Details cuando ya tenga la URL exacta de una creatividad.
¿Se pueden filtrar los anuncios de una empresa?
Sí. Los controles opcionales incluyen tema, región, rango de fechas, superficie de Google, formato y un results_limit acotado.
¿Estas API pueden acceder al rendimiento privado de las campañas?
No. Trabajan con registros públicos de transparencia y no exponen analíticas privadas de cuentas ni de campañas.
¿Cuánto cuestan los resultados?
Cada registro devuelto cuesta 0.5 créditos de SocQ, sin cargo base configurado para un resultado vacío.
Combine datos de varias plataformas para obtener información de negocio más completa
Reúna en un mismo flujo de trabajo perfiles públicos, contenido y datos de interacción de distintas plataformas para dar seguimiento a marcas, creadores y temas, y para realizar monitoreo y análisis entre plataformas con más eficiencia.
Google Maps API
Descubra lugares públicos, consulte detalles normalizados de URL conocidas de Maps y obtenga reseñas públicas con contexto del lugar y del autor vinculado a la fuente.
Amazon API
Busque productos públicos de Amazon y obtenga registros normalizados de detalles de productos, Best Sellers, reseñas, perfiles de vendedores y tiendas de creadores de los marketplaces compatibles.
Apple App Store API
Obtenga detalles públicos de apps de Apple App Store, clasificaciones por categoría y reseñas a partir de URL conocidas de la tienda, como registros normalizados de apps y reseñas.
SEO API
Consulte resultados orgánicos de Google en vivo, compare la demanda de palabras clave y la dificultad de posicionamiento, amplíe términos semilla, descubra las palabras clave y las páginas que impulsan la visibilidad de un sitio en las búsquedas, clasifique la intención de búsqueda y recopile resultados de Google News, Google Images, Google Autocomplete, Bing y YouTube. Todos los endpoints usan la misma clave de API de SocQ, el mismo flujo de tareas asíncronas y el mismo formato de resultados normalizado.
Telegram API
Lea canales públicos de Telegram a partir de sus enlaces t.me: perfiles de canal con suscriptores, publicaciones con vistas y reacciones, publicaciones sueltas, comentarios de grupos de discusión, canales similares y búsqueda en todo el historial.
Link in Bio API
Convierta el único enlace de la bio de Instagram, TikTok o YouTube de un creador en datos estructurados: nombre visible, bio, avatar, correo de contacto indicado, perfiles sociales vinculados y cada botón de la página con su título y destino.


