Docs

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

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

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