Docs

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.

Shell
export ADLIB_API_KEY="your-key"

2. Werbekonten eines Unternehmens finden

Löse eine Domain in ihre Werbetreibenden auf allen zwölf Plattformen auf:

Shell
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:

Shell
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:

Shell
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):

Shell
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