Docs

n8n, Clay et no-code

Utilisez AdLib depuis n8n et Clay avec une étape HTTP, depuis Google Sheets avec des colonnes à plat ou du CSV, et depuis Slack, Discord, Make ou Zapier grâce aux webhooks des listes de suivi. Rien à installer.

n8n

Utilisez un nœud HTTP Request : méthode GET, une URL comme https://api.adlibapi.com/v1/domains/{{ $json.domain }}/check et un en-tête X-API-Key avec votre clé (enregistrez-la comme credential Header Auth). Même principe pour resolve, la recherche et l’historique d’un annonceur. Pour réagir aux mouvements des concurrents, faites pointer le webhook_url d’une liste de suivi vers un déclencheur Webhook de n8n et créez une branche pour les publicités nouvelles, arrêtées, modifiées et retirées.

Un community node AdLib dédié à n8n arrive bientôt ; en attendant sa publication, passez par le nœud HTTP Request.

Clay

Ajoutez une colonne HTTP API : méthode GET, URL https://api.adlibapi.com/v1/domains/{{Domain}}/check, en-tête X-API-Key avec votre clé. La réponse contient un objet à plat data.columns conçu pour le mapping de colonnes (advertising, platforms_advertising, total_active_ads, latest_ad_at, un jeu par plateforme). Chaque vérification coûte 3 crédits ; celles où aucune plateforme n’a pu être jointe sont gratuites.

Des colonnes prêtes à l’emploi pour le lead scoring, la personnalisation à partir des textes publicitaires et les alertes concurrents sont dans Modèles Clay.

Liens des bibliothèques publicitaires

Collez un lien copié depuis n’importe quelle bibliothèque et obtenez l’identifiant AdLib ainsi que l’appel qui le récupère (gratuit) :

Shell
curl -G "https://api.adlibapi.com/v1/library-url" \
  --data-urlencode "url=https://www.facebook.com/ads/library/?id=1187430977361020" \
  -H "X-API-Key: $ADLIB_API_KEY"

Fonctionne avec la Meta Ad Library, le Google Ads Transparency Center, la TikTok Ad Library, la LinkedIn Ad Library, le Pinterest Ads Repository et les posts X.

Slack et Discord

Mettez l’URL d’un webhook Slack ou Discord dans le webhook_url d’une liste de suivi : les alertes arrivent sous forme de messages lisibles dans ce canal, sans middleware. Vous préférez votre boîte mail ? Définissez email_alerts: true et les changements de chaque passage arrivent dans un récapitulatif par e-mail. Voir Listes de suivi et webhooks.

Make et Zapier

Il n’existe pas encore d’app AdLib dans Make ou Zapier. Utilisez leur déclencheur générique Webhooks (« Catch hook ») et mettez son URL dans le webhook_url d’une liste de suivi ; chaque événement advertiser.changes arrive en JSON avec les publicités nouvelles, arrêtées, modifiées et retirées. Pour appeler l’API depuis un scénario ou un zap, utilisez l’action générique HTTP ou Webhooks avec l’en-tête X-API-Key. Voir Listes de suivi et webhooks.

Google Sheets, Excel et outils de BI

Ajoutez output=csv à n’importe quel endpoint et la réponse revient en CSV : une ligne par publicité (ou une ligne pour une vérification de domaine), les champs imbriqués en colonnes pointées comme advertiser.name ou creatives.0.text, les listes jointes par |. Le curseur de la page suivante est dans l’en-tête X-Next-Cursor.

Shell
curl "https://api.adlibapi.com/v1/search?advertiser=meta:15087023444&source=history&output=csv" \
  -H "X-API-Key: $ADLIB_API_KEY" -o ads.csv

Les crédits sont les mêmes qu’en JSON. Tout outil capable d’appeler une API REST avec un en-tête fonctionne. Des SDK officiels pour JavaScript et Python arrivent bientôt ; d’ici là, la spécification OpenAPI 3.1 permet de générer un client dans la plupart des langages.