Pular para o conteúdo

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

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

  2. Estime o preço

    Envie sua lista para POST /estimates para ver o preço e qualquer problema nela. Nada é cobrado.

  3. Faça o pedido

    Envie a mesma lista para POST /orders com uma Idempotency-Key. O pedido é cobrado uma única vez, não importa quantas vezes você o envie.

  4. Busque o resultado

    Consulte GET /orders/{id} até terminar e depois baixe o arquivo em GET /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 /estimates e POST /orders: ler uma lista grande leva tempo. Com um timeout menor, você acaba enviando de novo à toa.

Nesta página