API V2
La version 2 de l'API Captain Verify est désormais disponible et elle comporte de nouvelles fonctionnalités. Si vous cherchez un moyen fiable de vérifier la validité de vos emails, vous pouvez intégrer l'API de vérification des emails de Captain Verify dans vos propres applications.
Clé API
Un compte est nécessaire pour générer la clé pour l'API, c'est ce qui vous donnera accès au service.
Limites de l'API
L'API est limitée à un maximum de 2 connexions simultanées et 50 vérifications par minute. Lorsque vous intégrez l'API, assurez-vous que votre application ne dépasse pas cette limite.
La requête
Pour faire une demande à l'API, appelez simplement le protocole GET à cette URL :
https://api.captainverify.com/v2/verify?apikey=XXXXXXXXXXXXXXXXXXXX&email=john.doe@gmail.com
Remplacez john.doe@gmail.com par votre email pour vérifier.
La réponse
Une table json sera renvoyée avec ces variables:
{
"credits":870,
"result":"invalid",
"details":"unknown_email",
"free":true,
"role":false,
"disposable":false,
"ok4all":false,
"protected":false,
"did_you_mean":"john.doe@gmail.com",
"email":"john.doe@gmail.com",
"email_normalized":"john.doe@gmail.com",
"success":true,
"message":null
}
| Variables | Valeur possible |
|---|---|
| credits | Crédits disponibles sur votre compte. |
| result | valid, invalid, risky, unknown Le statut de l'email. si tous vos crédits ont été épuisés, le statut inconnu sera toujours retourné, pour ne pas bloquer votre application. |
| details | null, email error, greylisting, low quality, low deliverability, mailboxfull... Comprendre le résultat d'une vérification. |
| free | true, false Si le fournisseur de messagerie est gratuit, ex : Gmail.com. |
| role | true, false Si l'utilisateur du courrier électronique a un rôle, ex: support@exemple.com. |
| disposable | true, false L'email est valide, mais jetable après une courte période il ne sera plus possible de contacter l'utilisateur. |
| ok4all | true, false Ok pour tout : le serveur de messagerie distant accepte tous les e-mails (catch-all). |
| protected | true, false L'email est protégé par une solution antispam propriétaire |
| mailboxfull | true, false L'adresse e-mail est pleine. Elle ne peut plus recevoir de courrier |
| did_you_mean | default : null Si par exemple, le courrier électronique est john.doe@gmil.com, l'API vous enverra une proposition comme john.doe@gmail.com. |
| L'email que vous souhaitez vérifier. | |
| email_normalized | L'email a normalisé, l'élimination des étiquettes pour gmail ... support+test@gmail.com sera support@gmail.com. |
| success | true, false Si l'authentification a échoué, l'épuisement de vos crédits. |
| message | default : null Lorsque le succès est faux, un message d'erreur sera envoyé. |
Pourquoi intégrer une API de vérification d'email ?
Une base de contacts se dégrade vite. Adresses saisies avec une faute de frappe, emails jetables créés pour passer un formulaire, boîtes abandonnées puis fermées : chaque adresse invalide qui entre dans votre système finit en hard bounce. Et les bounces coûtent cher. Ils gonflent vos factures d'envoi, faussent vos statistiques de campagne et, surtout, dégradent votre réputation d'expéditeur auprès des fournisseurs de messagerie.
Le nettoyage manuel arrive toujours trop tard. Une fois l'adresse enregistrée dans votre CRM, elle a déjà pollué vos segments, vos scores de lead et vos exports. La vérification programmatique inverse la logique : l'adresse est contrôlée au moment précis de la collecte, avant d'être stockée.
C'est exactement le rôle d'une API de vérification d'email. Vous envoyez une adresse, vous recevez un verdict exploitable par votre code, et vous décidez quoi en faire : accepter, rejeter ou demander une correction à l'utilisateur. Le tout sans intervention humaine.
Cas d'usage de l'API
Validation en temps réel à l'inscription
Branchez l'API sur vos formulaires d'inscription, de téléchargement ou de devis. Les fautes de frappe (gmail devenu gmial), les emails jetables et les adresses inexistantes sont détectés avant l'enregistrement. L'utilisateur peut corriger immédiatement sa saisie, et seules des adresses valides entrent dans votre base.
Nettoyage en masse avant campagne
Une liste qui dort quelques mois accumule des adresses mortes. Avant un envoi important, passez-la à l'API pour écarter les adresses invalides ou risquées. Résultat : un bounce rate maîtrisé, des statistiques de campagne fiables et un budget d'envoi concentré sur des destinataires qui existent réellement.
Fiabilisation du CRM
Connectez la vérification à vos points d'entrée de données : imports, intégrations, saisies commerciales. Chaque contact est qualifié dès sa création, avec un statut clair sur la validité de son email. Vos équipes travaillent sur des fiches propres et votre scoring de leads repose sur des données réelles.
Protection de la réputation d'expéditeur
Les fournisseurs de messagerie surveillent vos hard bounces et vos envois vers des spam traps. Trop d'incidents, et vos emails légitimes finissent en spam. En filtrant les adresses dangereuses avant chaque envoi, l'API protège votre réputation d'expéditeur et donc la délivrabilité de l'ensemble de vos communications.
Questions fréquentes sur l'API
Que vérifie exactement l'API ?
Plusieurs contrôles s'enchaînent : syntaxe de l'adresse, existence du domaine et de ses enregistrements MX, puis test SMTP pour vérifier que la boîte accepte les messages. L'API détecte aussi les emails jetables et les adresses rôle (contact@, info@). La réponse est renvoyée au format JSON.
L'API fonctionne-t-elle en temps réel ?
Oui. Chaque requête déclenche une vérification immédiate et renvoie le résultat dans la foulée, ce qui permet de l'intégrer directement dans un formulaire ou un parcours d'inscription. Pour les gros volumes, la vérification de fichiers complets reste disponible depuis votre compte.
Combien ça coûte ?
La facturation fonctionne par crédits : une vérification consomme un crédit, sans abonnement obligatoire. Les crédits achetés servent aussi bien à l'API qu'à la vérification de fichiers. Le détail des volumes et des prix dégressifs est disponible sur la page de nos tarifs.