Aller au contenu

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

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

  2. Estimez le prix

    Envoyez votre liste à POST /estimates pour voir le prix et tout problème qu’elle présente. Rien n’est débité.

  3. Passez la commande

    Envoyez la même liste à POST /orders avec une Idempotency-Key. La commande n’est débitée qu’une seule fois, quel que soit le nombre d’envois.

  4. Récupérez le résultat

    Consultez GET /orders/{id} jusqu’à ce que la commande soit terminée, puis récupérez le fichier avec GET /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 /estimates et de POST /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.

Sur cette page