Einführung
AdLib ist eine REST-API für die öffentlichen Werbebibliotheken von Meta, Google, YouTube, Google Play, TikTok, LinkedIn, Pinterest, X, Snapchat, dem Apple App Store, Amazon und Microsoft Bing, mit einem Archiv der Anzeigen, die die Plattformen nicht mehr zeigen.
AdLib liest die öffentlichen Werbebibliotheken von zwölf Plattformen und liefert jede Anzeige im selben Format. Anzeigen, die wir gesehen haben, bleiben mit Datum und Creatives in unserem Archiv. Auch dann, wenn die Plattform sie ausblendet.
Was du damit machen kannst
- Die Werbekonten eines Unternehmens finden, ausgehend von der Domain und auf jeder Plattform: Von der Domain zum Werbetreibenden.
- Anzeigen suchen nach Stichwort, Werbetreibendem, Domain, Land, Datum und Format, über alle Plattformen:
GET /v1/search.platform=youtubeoderplatform=playliefert nur YouTube- bzw. Google-Play-Anzeigen aus Googles Transparency Center (wieplacement=youtube). - Sehen, was ein Unternehmen schaltet und wer das für es übernimmt: ein Call für alle Werbekonten einer Domain, eigene Konten getrennt von Agenturen und Resellern (
GET /v1/companies/{domain}), oder ein Ja/Nein pro Plattform für Lead-Listen (GET /v1/domains/{domain}/check, 3 Credits). - Den Verlauf lesen einer Anzeige oder eines Werbetreibenden, auch beendete Anzeigen und solche, die die Plattformen aus ihren Bibliotheken entfernt haben (
removed_from_library_at,source=history&removed=true): Anzeigenverlauf und Archiv. - Verstehen, warum eine Anzeige funktioniert: Videolänge, Seitenverhältnis, Schnitte, Ton, Text im Bild, Angebote, Dringlichkeit und Hook, dazu
derived.stage(testing, scaling, proven) bei jeder Anzeige: Creative-Merkmale. - Bescheid bekommen, wenn die Konkurrenz sich bewegt: Watchlists schicken neue, gestoppte, geänderte und entfernte Anzeigen an einen signierten Webhook, in einen Slack- oder Discord-Channel oder in dein Postfach: Watchlists und Webhooks.
- Die EU-Reichweite über die Zeit messen für Meta-Anzeigen, die in der EU liefen: EU-Reichweite im Zeitverlauf.
- Einen KI-Agenten damit arbeiten lassen über den gehosteten MCP-Server: MCP für KI-Agenten.
- In eine Tabelle exportieren mit
output=csv, einen beliebigen Link aus einer Werbebibliothek inGET /v1/library-urleinfügen oder die API aus Clay, n8n, Make oder Zapier mit einem HTTP-Schritt aufrufen: n8n, Clay und No-Code. - Viele Abfragen als einen Job laufen lassen: Batch-Jobs.
Plattformen
| Plattform | Bibliothek | Suche nach |
|---|---|---|
| Meta | Facebook & Instagram Ad Library | Stichwort, Seite, Domain |
| Ads Transparency Center (Search, Shopping, Maps) | Werbetreibender, Domain, placement |
|
| YouTube | Google Ads Transparency Center, platform=youtube |
Werbetreibender, Domain |
| Google Play | Google Ads Transparency Center, platform=play |
Werbetreibender, Domain |
| TikTok | Ad Library (EU, UK, CH) | Stichwort, Werbetreibender |
| Ad Library | Stichwort, Unternehmen, Domain | |
| Ads Repository (EU) | Werbetreibender, Domain | |
| X (Beta) | Ads Repository (EU) | Handle, Domain |
| Snapchat | Ads Gallery (EU) | Zahlender Werbetreibender, Domain; Impressionen pro EU-Land |
| Apple App Store | Ad Repository (EU) | Entwickler, App-Name, Domain; Platzierung im App Store |
| Amazon | Ad Library (EU-Shops) | Stichwort, Werbetreibender, Domain; Reichweite pro Land |
| Microsoft Bing (Beta) | Ad Library (EU/EWR) | Stichwort, Werbetreibender, Domain; Anteil der Impressionen pro Land |
Details zu jeder Plattform: Plattformen.
Grundlagen
| Basis-URL | https://api.adlibapi.com |
| Authentifizierung | Header X-API-Key: <your key> |
| Format | JSON, ein Schema für alle Plattformen |
| IDs | <platform>:<platform id>, zum Beispiel meta:15087023444 |
| Abrechnung | Credits pro gelieferten Treffer; leere Ergebnisse und Fehler sind kostenlos |
| Spezifikation | OpenAPI 3.1 |
Fang mit dem Quickstart an: Kostenloser Key und erste Anfrage dauern zwei Minuten.