Batch jobs
Envía hasta 100 dominios, anunciantes o anuncios en un solo job asíncrono y recoge los resultados cuando termine, con un webhook firmado opcional.
Un batch job hace muchas consultas en segundo plano, así no tienes que gestionar tú la concurrencia ni los límites de peticiones.
Lanza 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 |
Elementos | Qué hace con cada uno |
|---|---|---|
domains |
Dominios de empresas | Resuelve el dominio en todas las plataformas; con options.include_ads también trae la primera página de anuncios de cada cuenta |
advertisers |
Ids de anunciante | Trae los anuncios del anunciante, options.max_pages páginas (3 por defecto) |
ads |
Ids de anuncio | Trae cada anuncio |
options también acepta platforms, country y status. Elementos por job: 10 con los créditos gratuitos, 100 tras el primer pack de créditos.
Recoge los resultados
La respuesta incluye el id del job. Consulta el job periódicamente o espera al webhook:
curl "https://api.adlibapi.com/v1/batch/0b7c6a8e-1f2d-4c3b-9a8e-5d6f7a8b9c0d" \
-H "X-API-Key: $ADLIB_API_KEY"Los resultados se paginan con next_cursor. El webhook va firmado igual que los eventos de las listas de seguimiento; consulta Listas de seguimiento y webhooks.
Coste
Cada elemento se cobra como la llamada individual a la que sustituye, por ejemplo 10 créditos por un dominio resuelto o 1 crédito por anuncio de Meta. Los elementos que fallan no se cobran.