Volver a las API
Datos independientes de transparencia publicitaria pública

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.

FuncionalidadSocQProductos de Google Ads
Uso principalDescubrir y normalizar registros públicos de transparenciaAdministrar cuentas publicitarias y campañas autorizadas
EntradasConsulta, identificador de empresa y filtros, o URL exacta de una creatividadEntradas de cuenta, campaña o informes propias de cada producto
AutenticaciónClave de API de SocQCredenciales y autorización de Google propias de cada producto
Formato de respuestaRegistros públicos normalizados de anunciantes y anunciosRespuesta 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. 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. 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. 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.

Obtener los anuncios públicos de una empresa

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.

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.