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=youtubeoplatform=playdevuelve solo anuncios de YouTube o de Google Play del Transparency Center de Google (igual queplacement=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 enGET /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 |
| 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 |
| Ad Library | Palabra clave, empresa, dominio | |
| 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.