Desenvolvedores
Execute todos os verificadores do seu próprio servidor
A API do TalismanLeads faz o mesmo que o site: você envia uma lista, vê o preço, faz o pedido e busca o resultado. Você paga com o mesmo saldo, pelos mesmos preços.
Como funciona
Crie uma chave de API
Crie uma chave de API na sua conta. Ela é mostrada uma única vez, então guarde-a em um lugar seguro.
Estime o preço
Envie sua lista para
POST /estimatespara ver o preço e qualquer problema nela. Nada é cobrado.Faça o pedido
Envie a mesma lista para
POST /orderscom umaIdempotency-Key. O pedido é cobrado uma única vez, não importa quantas vezes você o envie.Busque o resultado
Consulte
GET /orders/{id}até terminar e depois baixe o arquivo emGET /orders/{id}/results.
Início rápido
Substitua a chave de API pela sua. O endereço base é https://api.talismanleads.io/v1, e as requisições e respostas são em JSON.
1. Veja quanto custaria
curl -X POST "https://api.talismanleads.io/v1/estimates" \
-H "Authorization: Bearer tl_live_your_key_here" \
-H "Content-Type: application/json" \
-d '{"checker":"whatsapp_status_detection","entries":["+14155550142","+12125550187"]}'2. Faça o pedido
curl -X POST "https://api.talismanleads.io/v1/orders" \
-H "Authorization: Bearer tl_live_your_key_here" \
-H "Idempotency-Key: crm-export-2026-11-05" \
-H "Content-Type: application/json" \
-d '{"checker":"whatsapp_status_detection","entries":["+14155550142","+12125550187"]}'3. Consulte o andamento
curl "https://api.talismanleads.io/v1/orders/ord_8f2c1e7a-3b4d-4c5e-9f60-1a2b3c4d5e6f" \
-H "Authorization: Bearer tl_live_your_key_here"4. Busque o resultado
curl "https://api.talismanleads.io/v1/orders/ord_8f2c1e7a-3b4d-4c5e-9f60-1a2b3c4d5e6f/results" \
-H "Authorization: Bearer tl_live_your_key_here"Bom saber
- Valores são sempre uma string em dólares americanos, como
"18.00". - Todo arquivo é faturado como pelo menos 2.000 entradas, na API e no site.
- Uma lista de até 100.000 entradas e 4 MB pode ir na requisição. Uma maior, de até 10.000.000 de entradas ou 200 MB, passa por
POST /uploads. - Consulte o status de um pedido com intervalos de 30 segundos ou mais. O tempo de um pedido depende do tamanho e do verificador.
- Aguarde até 5 minutos pela resposta de
POST /estimatesePOST /orders: ler uma lista grande leva tempo. Com um timeout menor, você acaba enviando de novo à toa.