Docs

Jobs par lots

Envoyez jusqu’à 100 domaines, annonceurs ou publicités dans un seul job asynchrone et récupérez les résultats une fois terminé, avec un webhook signé en option.

Un job par lots exécute de nombreuses recherches en arrière-plan : vous n’avez pas à gérer vous-même la concurrence ni les limites de débit.

Lancer un job

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 Éléments Ce que fait chaque élément
domains Domaines d’entreprises Résout le domaine sur chaque plateforme ; avec options.include_ads, récupère aussi la première page de publicités de chaque compte
advertisers Identifiants d’annonceurs Récupère les publicités de l’annonceur, options.max_pages pages (3 par défaut)
ads Identifiants de publicités Récupère chaque publicité

options accepte aussi platforms, country et status. Éléments par job : 10 avec les crédits gratuits, 100 après le premier pack de crédits.

Récupérer les résultats

La réponse contient l’identifiant du job. Interrogez le job régulièrement, ou attendez le webhook :

Shell
curl "https://api.adlibapi.com/v1/batch/0b7c6a8e-1f2d-4c3b-9a8e-5d6f7a8b9c0d" \
  -H "X-API-Key: $ADLIB_API_KEY"

Les résultats sont paginés avec next_cursor. Le webhook est signé comme les événements des listes de suivi ; voir Listes de suivi et webhooks.

Coût

Chaque élément est facturé comme l’appel unitaire qu’il remplace, par exemple 10 crédits pour un domaine résolu ou 1 crédit par publicité Meta. Les éléments en échec ne sont pas facturés.