google-ad-library/
ad

Obtenga una creatividad pública de Google Ads Transparency Center a partir de su URL exacta y reciba en un registro normalizado la identidad del anunciante, el texto, el contenido multimedia, las fechas de entrega, las regiones, el formato, el destino y las impresiones disponibles.

Google Ad Library Ad API

URL exacta de la creatividad
Anunciante y contenido multimedia
Contexto público de entrega
0.5 créditos por resultado
Listo
Listo

Ingrese los parámetros y envíe una solicitud. El estado de la tarea y los resultados normalizados aparecerán aquí.

README

Por SocQ · Actualizado el

Google Ad Library Ad

Las creatividades de Google Ads Transparency Center son registros publicitarios públicos con la identidad del anunciante, el texto y el contenido multimedia visibles, los enlaces de destino, los formatos, las fechas de entrega, las regiones y los datos de impresiones disponibles. Estos detalles sirven para verificar creatividades, enriquecer anuncios seleccionados, investigar el contexto de entrega y comparar archivos en momentos concretos.

Funcionalidades de la Google Ad Library Ad API

  • Resolución exacta de la creatividadResuelve una URL de adstransparency.google.com que contenga /creative/ en, como máximo, un registro público de anuncio normalizado, sin ampliar la solicitud a una búsqueda.
  • Campos del anunciante y de la creatividadDevuelve el identificador de la creatividad, la URL pública de origen, el texto disponible, la referencia del anunciante, el destino y el formato en un esquema de anuncio estable.
  • Contexto de entregaConserva las fechas de inicio y fin, los países y las ubicaciones disponibles, y un valor escalar de impresiones solo cuando los datos de la fuente se pueden normalizar con seguridad.
  • Recursos multimedia normalizadosExpone las referencias disponibles de imagen o video con miniaturas, dimensiones y duración, y omite los valores opcionales ausentes.

Parámetros de la Google Ad Library Ad API

ParámetrosObligatorioDescripción
urlObligatorioURL pública obligatoria de una creatividad de Google Ads Transparency Center. El esquema debe ser http o https, el host debe terminar en adstransparency.google.com y la ruta debe contener /creative/.

Cómo usar la Google Ad Library Ad API

Envíe la URL pública exacta de una creatividad, siga la tarea asíncrona y lea el registro de anuncio normalizado en el contenedor de resultados estándar.

  1. Prepare una URL http o https en adstransparency.google.com cuya ruta contenga /creative/.
  2. Envíe url por POST a /v1/google-ad-library/ad y guarde el task_id devuelto.
  3. Consulte /v1/tasks/{task_id} hasta que la tarea se complete con éxito o falle.
  4. Lea data.results.items; la operación de detalle devuelve como máximo un elemento, por lo que has_more normalmente es false y next_cursor normalmente es null.
curl -X POST "https://api.socq.ai/v1/google-ad-library/ad" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://adstransparency.google.com/advertiser/AR01614014350098432001/creative/CR10449491775734153217"}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items; this detail operation returns at most one item

Casos de uso de la Google Ad Library Ad API

  • Enriquecer una creatividad seleccionada: Use el ID de la creatividad, la referencia del anunciante, el texto, el destino, el formato, el contenido multimedia y la URL de origen para completar un registro de anuncio descubierto previamente.
  • Revisar la evidencia pública de entrega: Compare las fechas, los países, las ubicaciones y las impresiones disponibles para documentar dónde y cuándo se observó públicamente una creatividad conocida.
  • Archivar instantáneas de creatividades: Almacene los campos normalizados de texto, contenido multimedia, anunciante, entrega, destino y collected_at para compararlos después en momentos concretos.

Consejos de expertos para la Google Ad Library Ad API

  • Envíe la URL completa de la creatividad y no un identificador CR suelto ni la URL del anunciante, para que el host y la ruta /creative/ pasen la validación.
  • Trate por separado una tarea exitosa sin elementos y un error del proveedor; una creatividad eliminada, restringida o no disponible puede no producir ningún registro utilizable.
  • Conserve como nulos los campos de entrega, texto, destino, anunciante, impresiones y contenido multimedia, en lugar de convertir los valores públicos ausentes en cero o en afirmaciones vacías.
  • Use la búsqueda de anunciantes y los anuncios de empresa para tareas de descubrimiento o de inventario; esta operación de detalle resuelve deliberadamente solo la creatividad enviada.

Además de la Google Ad Library Ad API, use estas APIs cuando necesite otro tipo de datos públicos de Google Ad Library.

  • Google Ad Library Advertiser Search API — Descubre anunciantes candidatos del Transparency Center por consulta y región opcional, con campos de identidad, sitio web, logotipo, región y cantidad de anuncios disponible.
  • Google Ad Library Company Ads API — Recolecta creativos públicos del Transparency Center por dominio de empresa o ID de anunciante, con controles de tema, región, fecha, superficie, formato y límite de resultados.

Explorar otras plataformas

Combine los datos de Google Ad Library con datos públicos de otras plataformas sociales compatibles.

Google Ad Library Ad API — FAQ

Google Ad Library Ad API es una interfaz programática para obtener una creatividad pública de Google Ads Transparency Center a partir de su URL exacta. Devuelve campos normalizados de anunciante, texto, contenido multimedia, entrega, región, formato, destino e impresiones disponibles.

Envíe una URL http o https cuyo host termine en adstransparency.google.com y cuya ruta contenga /creative/. No se aceptan ID de creatividad sueltos, URL de anunciantes, dominios, consultas ni listas de URL.

El registro normalizado declara identidad, URL de origen, texto, anunciante, fechas de entrega, países, plataformas, formato, destino, impresiones, contenido multimedia, momento de publicación y momento de recopilación. Los campos que dependen de la fuente pueden ser nulos, y el contenido multimedia puede estar vacío.

Una URL de creatividad válida puede corresponder a un registro público eliminado, restringido, mal formado o no disponible en este momento. El endpoint no sustituye la creatividad por otra ni convierte la solicitud en una búsqueda.

Cada registro devuelto cuesta 0.5 créditos de SocQ. La política configurada para resultados vacíos cobra solo la base de cero créditos cuando no se devuelve ningún registro.