Docs

Introducción

AdLib es una sola API REST sobre las bibliotecas de anuncios públicas de Meta, Google, YouTube, Google Play, TikTok, LinkedIn, Pinterest, X, Snapchat, el Apple App Store, Amazon y Microsoft Bing, con un archivo de los anuncios que las plataformas ya no muestran.

AdLib lee las bibliotecas de anuncios públicas de doce plataformas y te devuelve cada anuncio en el mismo formato. Los anuncios que hemos visto se quedan en nuestro archivo con sus fechas y creatividades, también cuando la plataforma los oculta.

Qué puedes hacer

  • Encontrar las cuentas publicitarias de una empresa en todas las plataformas a partir de su dominio: Del dominio a los anunciantes.
  • Buscar anuncios por palabra clave, anunciante, dominio, país, fecha y formato en todas las plataformas: GET /v1/search. platform=youtube o platform=play devuelve solo anuncios de YouTube o de Google Play del Transparency Center de Google (igual que placement=youtube).
  • Ver qué anuncios tiene una empresa y quién se los gestiona: una llamada para todas las cuentas publicitarias de un dominio, con las cuentas propias separadas de agencias y revendedores (GET /v1/companies/{domain}), o un sí o no por plataforma para listas de leads (GET /v1/domains/{domain}/check, 3 créditos).
  • Consultar el historial de un anuncio o de un anunciante, incluidos los anuncios que terminaron y los que las plataformas retiraron de sus bibliotecas (removed_from_library_at, source=history&removed=true): Historial de anuncios y el archivo.
  • Entender por qué funciona un anuncio: duración del vídeo, relación de aspecto, cortes, sonido, texto en la imagen, ofertas, urgencia y el gancho, además de derived.stage (testing, scaling, proven) en cada anuncio: Características creativas.
  • Enterarte cuando la competencia se mueve: las listas de seguimiento envían los anuncios nuevos, detenidos, modificados y retirados a un webhook firmado, a un canal de Slack o Discord, o a tu correo: Listas de seguimiento y webhooks.
  • Medir el alcance en la UE a lo largo del tiempo de los anuncios de Meta mostrados en la UE: Alcance en la UE a lo largo del tiempo.
  • Dejar que la use un agente de IA a través del servidor MCP alojado: MCP para agentes de IA.
  • Exportar a una hoja de cálculo con output=csv, pegar cualquier enlace de una biblioteca de anuncios en GET /v1/library-url, o llamar a la API desde Clay, n8n, Make o Zapier con un paso HTTP: n8n, Clay y no-code.
  • Lanzar muchas consultas como un solo trabajo: Trabajos por lotes.

Plataformas

Plataforma Biblioteca Búsqueda por
Meta Facebook & Instagram Ad Library Palabra clave, página, dominio
Google Ads Transparency Center (Search, Shopping, Maps) Anunciante, dominio, placement
YouTube Google Ads Transparency Center, platform=youtube Anunciante, dominio
Google Play Google Ads Transparency Center, platform=play Anunciante, dominio
TikTok Ad Library (UE, Reino Unido, CH) Palabra clave, anunciante
LinkedIn Ad Library Palabra clave, empresa, dominio
Pinterest Ads Repository (UE) Anunciante, dominio
X (beta) Ads Repository (UE) Usuario (@), dominio
Snapchat Ads Gallery (UE) Anunciante que paga, dominio; impresiones por país de la UE
Apple App Store Ad Repository (UE) Desarrollador, nombre de la app, dominio; ubicación en el App Store
Amazon Ad Library (tiendas de la UE) Palabra clave, anunciante, dominio; alcance por país
Microsoft Bing (beta) Ad Library (UE/EEE) Palabra clave, anunciante, dominio; cuota de impresiones por país

Los detalles de cada plataforma están en Plataformas.

Lo básico

URL base https://api.adlibapi.com
Autenticación Cabecera X-API-Key: <your key>
Formato JSON, un mismo esquema para todas las plataformas
Ids <platform>:<platform id>, por ejemplo meta:15087023444
Facturación Créditos por resultado entregado; los resultados vacíos y los errores son gratis
Especificación OpenAPI 3.1

Empieza por la guía de inicio rápido: conseguir una clave gratis y hacer tu primera petición lleva dos minutos.