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
Crea una chiave API
Crea una chiave API nel tuo account. Viene mostrata una sola volta, quindi conservala in un posto sicuro.
Stima il prezzo
Invia la tua lista a
POST /estimatesper vedere il prezzo e qualsiasi problema della lista. Non viene addebitato nulla.Effettua l’ordine
Invia la stessa lista a
POST /orderscon unaIdempotency-Key. L’ordine viene addebitato una sola volta, indipendentemente da quante volte lo invii.Recupera il risultato
Controlla
GET /orders/{id}finché non è terminato, poi scarica il file daGET /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 /estimatesePOST /orders: leggere una lista grande richiede tempo. Con un timeout più breve finisci per inviarla di nuovo inutilmente.