Monte uma lista de leads verificada em uma chamada
O que você vai construir: uma lista verificada de pessoas em empresas que batem com seus filtros, usando o fluxo lead-list no servidor — primeiro cotado, depois executado e então exportado como CSV.
| Seção | Fluxos no servidor |
|---|---|
| Ações usadas | POST /v1/data/workflows/lead-list:estimatePOST /v1/data/workflows/lead-list |
| Créditos | 7 por pessoa encontrada (pior caso) |
| Funciona com chave de teste | Não — precisa de uma chave real |
| Tempo estimado | ~15 min |
| Pré-requisitos | Uma chave qk_live_ com saldo de créditos. Esta receita toca fontes pagas, então uma chave de teste devolve dados fixos em vez de resultados reais. |
O que o fluxo encadeia
Três etapas rodam do nosso lado por pessoa: encontrar candidatos que batem com seus filtros, encontrar o endereço de e-mail e então verificar esse endereço. Você envia uma requisição em vez de orquestrar três, e cada etapa só é cobrada quando produz algo.
# Discover what is available to your key rather than
# trusting a list copied from a page.
curl https://api.qannasapi.com/v1/data/workflows \
-H "Authorization: Bearer $QANNAS_API_KEY"Cote com dry_run
Envie o corpo do fluxo com dry_run: true e você recebe o detalhamento de créditos por etapa sem executar nada. Este é o número para orçar — ele assume que cada etapa dá certo para cada pessoa.
curl -X POST https://api.qannasapi.com/v1/data/workflows/lead-list \
-H "Authorization: Bearer $QANNAS_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"inputs": {"industry": "logistics", "country": "AE"},
"limit": 25,
"dry_run": true
}'
# < X-Credits-Charged: 0 # the quote is freeExecute
Tire o dry_run e envie o mesmo corpo. Defina format como csv se quiser um arquivo em vez de JSON; markdown também está disponível. A resposta traz os mesmos cabeçalhos de créditos de qualquer outra chamada, então dá para conciliar a execução com a cotação na hora.
# Same body, without dry_run. format: json | csv | markdown
curl -X POST https://api.qannasapi.com/v1/data/workflows/lead-list \
-H "Authorization: Bearer $QANNAS_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"inputs": {"industry": "logistics", "country": "AE"},
"limit": 25,
"format": "csv"
}'
# < X-Credits-Charged: 138 # reconcile this against the quoteAtualize por delta
Ative track_delta na primeira execução e passe o cursor devolvido como since_cursor na seguinte para receber só o que mudou. Note que o delta é um filtro sobre o que você recebe, não um desconto sobre o que você paga.
# Run one: ask for a cursor.
curl -X POST https://api.qannasapi.com/v1/data/search/people \
-H "Authorization: Bearer $QANNAS_API_KEY" \
-d '{"query": "logistics AE", "track_delta": true}'
# Run two: receive only what changed.
# NOTE: delta filters what you RECEIVE. It is not a discount.
curl -X POST https://api.qannasapi.com/v1/data/search/people \
-H "Authorization: Bearer $QANNAS_API_KEY" \
-d '{"query": "logistics AE", "since_cursor": "cur_..."}'Resumo
| Padrão | Como |
|---|---|
| Cotar | POST /v1/data/workflows/lead-list com dry_run: true |
| Executar | O mesmo corpo, sem dry_run |
| Etapas encadeadas | busca → achar e-mail → verificar, cobrado por etapa |
| Formato de saída | format: json | csv | markdown |
| Atualização incremental | track_delta na primeira execução, since_cursor depois |
| Forma do custo | Por pessoa encontrada, não por pessoa solicitada |
Checklist de produção
- Cote com dry_run antes de cada execução agendada, não só a primeira.
- Orce pelo teto; concilie por X-Credits-Charged.
- Guarde o cursor de delta junto com a lista, não na memória da aplicação.
- Reverifique os endereços periodicamente — a entregabilidade se degrada.
Próximos passos
Rode a estimativa primeiro. Ela não custa nada e aplica exatamente a mesma aritmética que o medidor.