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