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.
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 :
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 :
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 :
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) :
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
- Recherchez sur plusieurs plateformes avec
GET /v1/search, ou dans l’archive avecsource=history. - Comprenez pourquoi une publicité marche : Caractéristiques créatives.
- Les alertes en détail, avec des webhooks signés : Listes de suivi et webhooks.
- Utilisez l’API depuis Claude ou Cursor : MCP pour les agents IA.