Docs

Démarrage rapide

Obtenez une clé API gratuite et faites vos premières requêtes AdLib : trouvez les comptes publicitaires de Nike, puis récupérez leurs publicités.

1. Obtenir une clé

Inscrivez-vous avec votre adresse e-mail. Un nouveau compte reçoit une fois 2 000 crédits gratuits, sans carte bancaire. Créez une clé dans le tableau de bord, rubrique Clés. Elle ne s’affiche qu’une fois : enregistrez-la tout de suite.

Shell
export ADLIB_API_KEY="your-key"

2. Trouver les comptes publicitaires d’une entreprise

Résolvez un domaine en ses annonceurs sur les douze plateformes :

Shell
curl "https://api.adlibapi.com/v1/advertisers/resolve?domain=nike.com" \
  -H "X-API-Key: $ADLIB_API_KEY"

Chaque résultat a un identifiant comme meta:15087023444, un score de 0 à 1 et un match_reason. Cet appel coûte 10 crédits dès qu’il trouve au moins une correspondance.

3. Récupérer les publicités

Utilisez l’identifiant d’un annonceur pour lister ses publicités :

Shell
curl "https://api.adlibapi.com/v1/advertisers/meta:15087023444/ads?status=active" \
  -H "X-API-Key: $ADLIB_API_KEY"

Chaque publicité a les mêmes champs sur toutes les plateformes : texte, médias, dates, pays et, quand la plateforme les publie, portée UE et ciblage. Voir L’objet publicité et les identifiants.

4. Vérifier ce que ça a coûté

Chaque réponse indique les crédits consommés dans X-Billing-Credits. Votre consommation par jour et par endpoint :

Shell
curl "https://api.adlibapi.com/v1/usage" -H "X-API-Key: $ADLIB_API_KEY"

5. Être prévenu des changements

Ajoutez l’annonceur à une liste de suivi : la prochaine publicité nouvelle, arrêtée, modifiée ou retirée arrive dans Slack (ou Discord, votre propre endpoint ou votre boîte mail) :

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}'

Et ensuite