Schnellstart
Hol dir einen kostenlosen API-Key und schick deine ersten Requests an AdLib: Finde die Werbekonten von Nike und ruf dann ihre Anzeigen ab.
1. Key holen
Registrier dich mit deiner E-Mail-Adresse. Ein neues Konto bekommt einmalig 2.000 kostenlose Credits, ohne Kreditkarte. Leg im Dashboard unter Keys einen Key an. Er wird nur einmal angezeigt, also speicher ihn sofort.
export ADLIB_API_KEY="your-key"2. Werbekonten eines Unternehmens finden
Löse eine Domain in ihre Werbetreibenden auf allen zwölf Plattformen auf:
curl "https://api.adlibapi.com/v1/advertisers/resolve?domain=nike.com" \
-H "X-API-Key: $ADLIB_API_KEY"Jedes Ergebnis hat eine ID wie meta:15087023444, einen score zwischen 0 und 1 und einen match_reason. Der Aufruf kostet 10 Credits, wenn er mindestens einen Treffer findet.
3. Anzeigen abrufen
Mit einer Advertiser-ID listest du die Anzeigen auf:
curl "https://api.adlibapi.com/v1/advertisers/meta:15087023444/ads?status=active" \
-H "X-API-Key: $ADLIB_API_KEY"Jede Anzeige hat auf jeder Plattform dieselben Felder: Text, Medien, Daten, Länder und, wo die Plattform sie veröffentlicht, EU-Reichweite und Targeting. Mehr dazu unter Das Anzeigenobjekt und IDs.
4. Kosten prüfen
Jede Antwort enthält im Header X-Billing-Credits die verbrauchten Credits. Deinen Verbrauch pro Tag und Endpoint siehst du so:
curl "https://api.adlibapi.com/v1/usage" -H "X-API-Key: $ADLIB_API_KEY"5. Bei Änderungen Bescheid bekommen
Setz den Werbetreibenden auf eine Watchlist. Die nächste neue, gestoppte, geänderte oder gelöschte Anzeige landet dann in Slack (oder in Discord, an deinem eigenen Endpoint oder in deinem Postfach):
curl -X POST "https://api.adlibapi.com/v1/watchlists" \
-H "X-API-Key: $ADLIB_API_KEY" -H "Content-Type: application/json" \
-d '{"name": "Nike", "advertisers": ["meta:15087023444"], "webhook_url": "https://hooks.slack.com/services/...", "email_alerts": true}'Nächste Schritte
- Über alle Plattformen suchen mit
GET /v1/search, im Archiv mitsource=history. - Verstehen, warum eine Anzeige funktioniert: Creative-Merkmale.
- Alerts im Detail, mit signierten Webhooks: Watchlists und Webhooks.
- Aus Claude oder Cursor heraus nutzen: MCP für KI-Agenten.