Ontwikkelaars
Voer elke checker uit vanaf je eigen server
De TalismanLeads-API doet wat de website doet: een lijst sturen, de prijs zien, de bestelling plaatsen en het resultaat ophalen. Je betaalt met hetzelfde saldo, tegen dezelfde prijzen.
Hoe het werkt
Maak een API-sleutel aan
Maak een API-sleutel aan in je account. Die wordt één keer getoond, dus bewaar hem op een veilige plek.
Vraag een prijsraming op
Stuur je lijst naar
POST /estimatesom de prijs en eventuele problemen met de lijst te zien. Er wordt niets afgeschreven.Plaats de bestelling
Stuur dezelfde lijst naar
POST /ordersmet eenIdempotency-Key. De bestelling wordt één keer afgeschreven, hoe vaak je hem ook verstuurt.Haal het resultaat op
Controleer
GET /orders/{id}tot de bestelling klaar is en haal dan het bestand op viaGET /orders/{id}/results.
Snel beginnen
Vervang de API-sleutel door je eigen sleutel. Het basisadres is https://api.talismanleads.io/v1, en verzoeken en antwoorden zijn JSON.
1. Bekijk wat het zou kosten
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. Plaats de bestelling
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. Controleer de status
curl "https://api.talismanleads.io/v1/orders/ord_8f2c1e7a-3b4d-4c5e-9f60-1a2b3c4d5e6f" \
-H "Authorization: Bearer tl_live_your_key_here"4. Haal het resultaat op
curl "https://api.talismanleads.io/v1/orders/ord_8f2c1e7a-3b4d-4c5e-9f60-1a2b3c4d5e6f/results" \
-H "Authorization: Bearer tl_live_your_key_here"Goed om te weten
- Bedragen zijn altijd een string in Amerikaanse dollars, zoals
"18.00". - Elk bestand wordt gefactureerd als minstens 2.000 items, via de API net als op de website.
- Een lijst van maximaal 100.000 items en 4 MB past in het verzoek. Een grotere, tot 10.000.000 items of 200 MB, gaat via
POST /uploads. - Controleer de status van een bestelling met 30 seconden of meer ertussen. Hoe lang een bestelling duurt, hangt af van de grootte en de checker.
- Reken op maximaal 5 minuten voor een antwoord van
POST /estimatesenPOST /orders: een grote lijst inlezen kost tijd. Met een kortere time-out stuur je hem voor niets opnieuw.