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