Docs

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.

Shell
export ADLIB_API_KEY="your-key"

2. Encuentra las cuentas publicitarias de una empresa

Resuelve un dominio en sus anunciantes de las doce plataformas:

Shell
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:

Shell
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:

Shell
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):

Shell
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