Vai al contenuto

Sviluppatori

Esegui ogni verificatore dal tuo server

L’API di TalismanLeads fa ciò che fa il sito web: invii una lista, vedi il prezzo, effettui l’ordine e recuperi il risultato. Paghi con lo stesso saldo, agli stessi prezzi.

Come funziona

  1. Crea una chiave API

    Crea una chiave API nel tuo account. Viene mostrata una sola volta, quindi conservala in un posto sicuro.

  2. Stima il prezzo

    Invia la tua lista a POST /estimates per vedere il prezzo e qualsiasi problema della lista. Non viene addebitato nulla.

  3. Effettua l’ordine

    Invia la stessa lista a POST /orders con una Idempotency-Key. L’ordine viene addebitato una sola volta, indipendentemente da quante volte lo invii.

  4. Recupera il risultato

    Controlla GET /orders/{id} finché non è terminato, poi scarica il file da GET /orders/{id}/results.

Avvio rapido

Sostituisci la chiave API con la tua. L’indirizzo base è https://api.talismanleads.io/v1, e richieste e risposte sono in JSON.

1. Vedi quanto costerebbe

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. Effettua l’ordine

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. Controlla lo stato

curl "https://api.talismanleads.io/v1/orders/ord_8f2c1e7a-3b4d-4c5e-9f60-1a2b3c4d5e6f" \
  -H "Authorization: Bearer tl_live_your_key_here"

4. Recupera il risultato

curl "https://api.talismanleads.io/v1/orders/ord_8f2c1e7a-3b4d-4c5e-9f60-1a2b3c4d5e6f/results" \
  -H "Authorization: Bearer tl_live_your_key_here"

Da sapere

  • Gli importi sono sempre una stringa in dollari statunitensi, come "18.00".
  • Ogni file viene fatturato come almeno 2.000 voci, sull’API come sul sito web.
  • Una lista fino a 100.000 voci e 4 MB può stare nella richiesta. Una più grande, fino a 10.000.000 di voci o 200 MB, passa da POST /uploads.
  • Controlla lo stato di un ordine lasciando 30 secondi o più tra un controllo e l’altro. La durata di un ordine dipende dalle sue dimensioni e dal verificatore.
  • Attendi fino a 5 minuti la risposta di POST /estimates e POST /orders: leggere una lista grande richiede tempo. Con un timeout più breve finisci per inviarla di nuovo inutilmente.

In questa pagina