Docs

Jobs em lote

Envie até 100 domínios, anunciantes ou anúncios num único job assíncrono e pegue os resultados quando ele terminar, com um webhook assinado opcional.

Um job em lote roda muitas consultas em segundo plano, então você não precisa cuidar de concorrência e limites de requisições.

Inicie um 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 Itens O que cada item faz
domains Domínios de empresas Resolve o domínio em todas as plataformas; com options.include_ads, também busca a primeira página de anúncios de cada conta
advertisers Ids de anunciantes Busca os anúncios do anunciante, options.max_pages páginas (padrão 3)
ads Ids de anúncios Busca cada anúncio

options também aceita platforms, country e status. Itens por job: 10 com os créditos gratuitos, 100 depois do primeiro pacote de créditos.

Pegue os resultados

A resposta traz o id do job. Consulte o job periodicamente ou espere o webhook:

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

Os resultados são paginados com next_cursor. O webhook é assinado como os eventos das listas de monitoramento; veja Listas de monitoramento e webhooks.

Custo

Cada item é cobrado como a chamada avulsa que ele substitui, por exemplo 10 créditos por domínio resolvido ou 1 crédito por anúncio da Meta. Itens que falham não são cobrados.