Docs

Introduction

AdLib est une seule API REST sur les bibliothèques publicitaires publiques de Meta, Google, YouTube, Google Play, TikTok, LinkedIn, Pinterest, X, Snapchat, l’Apple App Store, Amazon et Microsoft Bing, avec une archive des publicités que les plateformes n’affichent plus.

AdLib lit les bibliothèques publicitaires publiques de douze plateformes et renvoie chaque publicité dans le même format. Les publicités que nous avons vues restent dans notre archive avec leurs dates et leurs créations, même après que la plateforme les a masquées.

Ce que vous pouvez faire

  • Trouver les comptes publicitaires d’une entreprise à partir de son domaine, sur toutes les plateformes : Du domaine aux annonceurs.
  • Rechercher des publicités par mot-clé, annonceur, domaine, pays, date et format sur plusieurs plateformes : GET /v1/search. platform=youtube ou platform=play ne renvoie que les publicités YouTube ou Google Play du Transparency Center de Google (comme placement=youtube).
  • Voir ce qu’une entreprise diffuse et qui le diffuse pour elle : un appel pour tous les comptes publicitaires d’un domaine, les comptes propres séparés de ceux des agences et des revendeurs (GET /v1/companies/{domain}), ou un oui/non par plateforme pour vos listes de leads (GET /v1/domains/{domain}/check, 3 crédits).
  • Lire l’historique d’une publicité ou d’un annonceur, y compris les publicités terminées et celles que les plateformes ont retirées de leurs bibliothèques (removed_from_library_at, source=history&removed=true) : Historique des publicités et archive.
  • Comprendre pourquoi une publicité marche : durée de la vidéo, format d’image, plans, son, texte à l’image, offres, urgence et accroche, plus derived.stage (testing, scaling, proven) sur chaque publicité : Caractéristiques créatives.
  • Être prévenu quand un concurrent bouge : les listes de suivi envoient les publicités nouvelles, arrêtées, modifiées et retirées vers un webhook signé, un canal Slack ou Discord, ou votre boîte mail : Listes de suivi et webhooks.
  • Mesurer la portée UE dans le temps des publicités Meta diffusées dans l’UE : Portée UE dans le temps.
  • Confier l’API à un agent IA via le serveur MCP hébergé : MCP pour les agents IA.
  • Exporter vers un tableur avec output=csv, coller n’importe quel lien de bibliothèque publicitaire dans GET /v1/library-url, ou appeler l’API depuis Clay, n8n, Make ou Zapier avec une étape HTTP : n8n, Clay et no-code.
  • Lancer de nombreuses recherches en un seul job : Jobs par lots.

Plateformes

Plateforme Bibliothèque Recherche par
Meta Facebook & Instagram Ad Library Mot-clé, page, domaine
Google Ads Transparency Center (Search, Shopping, Maps) Annonceur, domaine, placement
YouTube Google Ads Transparency Center, platform=youtube Annonceur, domaine
Google Play Google Ads Transparency Center, platform=play Annonceur, domaine
TikTok Ad Library (UE, Royaume-Uni, Suisse) Mot-clé, annonceur
LinkedIn Ad Library Mot-clé, entreprise, domaine
Pinterest Ads Repository (UE) Annonceur, domaine
X (bêta) Ads Repository (UE) Handle, domaine
Snapchat Ads Gallery (UE) Annonceur payeur, domaine ; impressions par pays de l’UE
Apple App Store Ad Repository (UE) Développeur, nom de l’app, domaine ; emplacement dans l’App Store
Amazon Ad Library (boutiques UE) Mot-clé, annonceur, domaine ; portée par pays
Microsoft Bing (bêta) Ad Library (UE/EEE) Mot-clé, annonceur, domaine ; part des impressions par pays

Le détail par plateforme : Plateformes.

L’essentiel

URL de base https://api.adlibapi.com
Authentification En-tête X-API-Key: <your key>
Format JSON, un seul schéma pour toutes les plateformes
Identifiants <platform>:<platform id>, par exemple meta:15087023444
Facturation Crédits par résultat livré ; les résultats vides et les erreurs sont gratuits
Spécification OpenAPI 3.1

Commencez par le Démarrage rapide : une clé gratuite et votre première requête prennent deux minutes.