Batch-Jobs
Schick bis zu 100 Domains, Werbetreibende oder Anzeigen in einem asynchronen Job und hol die Ergebnisse ab, wenn er fertig ist, optional mit signiertem Webhook.
Ein Batch-Job erledigt viele Abfragen im Hintergrund. Um Parallelität und Rate Limits musst du dich nicht selbst kümmern.
Job starten
curl -X POST "https://api.adlibapi.com/v1/batch" \
-H "X-API-Key: $ADLIB_API_KEY" -H "Content-Type: application/json" \
-d '{"type": "domains", "items": ["nike.com", "adidas.com", "puma.com"],
"webhook_url": "https://hooks.example.com/adlib-batch"}'type |
Einträge | Was pro Eintrag passiert |
|---|---|---|
domains |
Domains von Unternehmen | Löst die Domain auf jeder Plattform auf. Mit options.include_ads kommt pro Konto auch die erste Seite Anzeigen dazu |
advertisers |
Advertiser-IDs | Ruft die Anzeigen des Werbetreibenden ab, options.max_pages Seiten (Standard 3) |
ads |
Anzeigen-IDs | Ruft jede Anzeige ab |
options nimmt außerdem platforms, country und status. Einträge pro Job: 10 mit den kostenlosen Credits, 100 nach dem ersten Credit-Paket.
Ergebnisse abholen
Die Antwort enthält die Job-ID. Frag den Job regelmäßig ab oder warte auf den Webhook:
curl "https://api.adlibapi.com/v1/batch/0b7c6a8e-1f2d-4c3b-9a8e-5d6f7a8b9c0d" \
-H "X-API-Key: $ADLIB_API_KEY"Die Ergebnisse sind mit next_cursor paginiert. Der Webhook ist signiert wie die Watchlist-Events, siehe Watchlists und Webhooks.
Kosten
Jeder Eintrag kostet so viel wie der einzelne Aufruf, den er ersetzt, zum Beispiel 10 Credits für eine aufgelöste Domain oder 1 Credit pro Meta-Anzeige. Fehlgeschlagene Einträge werden nicht berechnet.