Primeros pasos
Consigue una API key gratuita y haz tus primeras peticiones a AdLib: encuentra las cuentas publicitarias de Nike y luego trae sus anuncios.
1. Consigue una key
Regístrate con tu email. Las cuentas nuevas reciben una sola vez 2.000 créditos gratuitos, sin tarjeta. Crea una key en el dashboard, en Claves. Solo se muestra una vez, así que guárdala enseguida.
export ADLIB_API_KEY="your-key"2. Encuentra las cuentas publicitarias de una empresa
Resuelve un dominio en sus anunciantes de las doce plataformas:
curl "https://api.adlibapi.com/v1/advertisers/resolve?domain=nike.com" \
-H "X-API-Key: $ADLIB_API_KEY"Cada resultado trae un id como meta:15087023444, un score de 0 a 1 y un match_reason. Esta llamada cuesta 10 créditos cuando encuentra al menos una coincidencia.
3. Trae los anuncios
Usa un id de anunciante para listar sus anuncios:
curl "https://api.adlibapi.com/v1/advertisers/meta:15087023444/ads?status=active" \
-H "X-API-Key: $ADLIB_API_KEY"Todos los anuncios tienen los mismos campos en todas las plataformas: texto, medios, fechas, países y, cuando la plataforma lo publica, alcance en la UE y segmentación. Consulta El objeto anuncio y los ids.
4. Mira cuánto ha costado
Cada respuesta indica en X-Billing-Credits los créditos que ha consumido. Tu consumo por día y por endpoint:
curl "https://api.adlibapi.com/v1/usage" -H "X-API-Key: $ADLIB_API_KEY"5. Entérate cuando cambien
Añade el anunciante a una lista de seguimiento y el próximo anuncio nuevo, detenido, modificado o retirado te llegará a Slack (o a Discord, a tu propio endpoint o a tu correo):
curl -X POST "https://api.adlibapi.com/v1/watchlists" \
-H "X-API-Key: $ADLIB_API_KEY" -H "Content-Type: application/json" \
-d '{"name": "Nike", "advertisers": ["meta:15087023444"], "webhook_url": "https://hooks.slack.com/services/...", "email_alerts": true}'Siguientes pasos
- Busca en todas las plataformas con
GET /v1/search, o en el archivo consource=history. - Descubre por qué funciona un anuncio: Características creativas.
- Las alertas en detalle, con webhooks firmados: Listas de seguimiento y webhooks.
- Úsalo desde Claude o Cursor: MCP para agentes de IA.