Docs

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=youtube oder platform=play liefert nur YouTube- bzw. Google-Play-Anzeigen aus Googles Transparency Center (wie placement=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 in GET /v1/library-url einfü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
Google 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
LinkedIn Ad Library Stichwort, Unternehmen, Domain
Pinterest 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.