Développeurs
Lancez tous les vérificateurs depuis votre propre serveur
L’API TalismanLeads fait ce que fait le site web : envoyer une liste, voir le prix, passer la commande et récupérer le résultat. Vous payez avec le même solde, aux mêmes prix.
Comment ça marche
Créez une clé API
Créez une clé API dans votre compte. Elle n’est affichée qu’une seule fois, conservez-la donc en lieu sûr.
Estimez le prix
Envoyez votre liste à
POST /estimatespour voir le prix et tout problème qu’elle présente. Rien n’est débité.Passez la commande
Envoyez la même liste à
POST /ordersavec uneIdempotency-Key. La commande n’est débitée qu’une seule fois, quel que soit le nombre d’envois.Récupérez le résultat
Consultez
GET /orders/{id}jusqu’à ce que la commande soit terminée, puis récupérez le fichier avecGET /orders/{id}/results.
Démarrage rapide
Remplacez la clé API par la vôtre. L’adresse de base est https://api.talismanleads.io/v1, et les requêtes et les réponses sont en JSON.
1. Voir ce que cela coûterait
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. Passer la commande
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. Suivre son état
curl "https://api.talismanleads.io/v1/orders/ord_8f2c1e7a-3b4d-4c5e-9f60-1a2b3c4d5e6f" \
-H "Authorization: Bearer tl_live_your_key_here"4. Récupérer le résultat
curl "https://api.talismanleads.io/v1/orders/ord_8f2c1e7a-3b4d-4c5e-9f60-1a2b3c4d5e6f/results" \
-H "Authorization: Bearer tl_live_your_key_here"Bon à savoir
- Les montants sont toujours une chaîne en dollars américains, comme
"18.00". - Chaque fichier est facturé au minimum 2 000 entrées, sur l’API comme sur le site web.
- Une liste de 100 000 entrées et 4 MB au maximum peut être placée dans la requête. Une liste plus grande, jusqu’à 10 000 000 d’entrées ou 200 MB, passe par
POST /uploads. - Consultez l’état d’une commande en laissant 30 secondes ou plus entre deux consultations. La durée d’une commande dépend de sa taille et du vérificateur.
- Prévoyez jusqu’à 5 minutes pour la réponse de
POST /estimateset dePOST /orders: la lecture d’une grande liste prend du temps. Avec un délai d’attente plus court, vous devrez renvoyer la requête pour rien.