Docs

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

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

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