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=youtubeouplatform=playne renvoie que les publicités YouTube ou Google Play du Transparency Center de Google (commeplacement=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 dansGET /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 |
| 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 |
| Ad Library | Mot-clé, entreprise, domaine | |
| 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.