API de recherche d'e-mails
Trouvez un e-mail professionnel vérifié à partir du prénom, du nom et du domaine de l'entreprise.
La recherche d'e-mails coûte 20 crédits, uniquement lorsqu'un e-mail vérifié est trouvé. Les recherches sans résultat vérifié, les saisies invalides et les résultats catch-all ne sont pas facturés. Les requêtes en masse et CSV nécessitent un solde de crédits suffisant pour les e-mails vérifiés que le traitement peut renvoyer.
Comment ça marche
- Vous envoyez
first_name,last_name, etdomain. - VeriMails recherche, pour le nom et le domaine fournis, une boîte mail nominative vérifiée.
- Un résultat n'est renvoyé qu'après une vérification en direct.
- Si aucune boîte vérifiée ne peut être confirmée, l'API renvoie
not_foundoucatch_all. - Pour les recherches de personnes, VeriMails renvoie une adresse nominative vérifiée lorsqu'elle peut être confirmée.
Trouver un e-mail
À utiliser pour des recherches à l'unité depuis votre application ou les outils de votre équipe.
| Champ | Obligatoire | Description |
|---|---|---|
first_name | Oui | Prénom de la personne. |
last_name | Oui | Nom de la personne. |
domain | Oui | Domaine de l'entreprise, par exemple acme.com. Les URL sont normalisées par l'API. |
curl -X POST https://verimails.com/api/find-email \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"first_name":"Jane","last_name":"Doe","domain":"company.com"}'
{
"found": true,
"email": "jane.doe@company.com",
"status": "found",
"confidence": 0.95,
"elapsed_ms": 420
}
Trouver jusqu'à 100 e-mails en mode synchrone
Utilisez l'endpoint synchrone en masse pour les petits lots. Les fichiers plus volumineux doivent passer par le parcours CSV ci-dessous.
curl -X POST https://verimails.com/api/find-email/bulk \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"leads": [
{"first_name":"Jane","last_name":"Doe","domain":"company.com"},
{"first_name":"Sam","last_name":"Lee","domain":"example.com"}
]
}'
Recherche d'e-mails par CSV
Importez un CSV lorsque vous devez trouver des e-mails à grande échelle. Le CSV doit contenir les colonnes prénom, nom et domaine. Les alias pris en charge incluent firstname, lastname, company_domain, website, et company_website.
first_name,last_name,domain
Jane,Doe,company.com
Sam,Lee,example.com
curl -X POST https://verimails.com/api/find-email/csv \
-H "Authorization: Bearer YOUR_API_KEY" \
-F "file=@leads.csv"
curl https://verimails.com/api/find-email/csv/JOB_ID \
-H "Authorization: Bearer YOUR_API_KEY"
curl https://verimails.com/api/find-email/csv/JOB_ID/download \
-H "Authorization: Bearer YOUR_API_KEY" -o finder_results.csv
Le CSV de sortie ajoute found_email, finder_status, finder_confidence, et finder_elapsed_ms.
Statuts
| Statut | Signification | Facturation |
|---|---|---|
found | Un e-mail vérifié a été trouvé. | Facturé |
not_found | Aucun e-mail nominatif vérifié n'a été trouvé. | Non facturé |
catch_all | Le domaine accepte des adresses de manière large, la boîte de réception ne peut donc pas être confirmée. | Non facturé |
invalid_input | Des champs obligatoires (nom ou domaine) sont manquants. | Non facturé |
insufficient_credits | Votre compte ne dispose pas d'assez de crédits pour la capacité demandée. | Non facturé |