Naar de inhoud

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

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

  2. Vraag een prijsraming op

    Stuur je lijst naar POST /estimates om de prijs en eventuele problemen met de lijst te zien. Er wordt niets afgeschreven.

  3. Plaats de bestelling

    Stuur dezelfde lijst naar POST /orders met een Idempotency-Key. De bestelling wordt één keer afgeschreven, hoe vaak je hem ook verstuurt.

  4. Haal het resultaat op

    Controleer GET /orders/{id} tot de bestelling klaar is en haal dan het bestand op via GET /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 /estimates en POST /orders: een grote lijst inlezen kost tijd. Met een kortere time-out stuur je hem voor niets opnieuw.

Op deze pagina