Docs/Recherche d'emails

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.

Voir le Markdown OpenAPI JSON
Règle de facturation

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

  1. Vous envoyez first_name, last_name, et domain.
  2. VeriMails recherche, pour le nom et le domaine fournis, une boîte mail nominative vérifiée.
  3. Un résultat n'est renvoyé qu'après une vérification en direct.
  4. Si aucune boîte vérifiée ne peut être confirmée, l'API renvoie not_found ou catch_all.
  5. Pour les recherches de personnes, VeriMails renvoie une adresse nominative vérifiée lorsqu'elle peut être confirmée.

Trouver un e-mail

POST /api/find-email

À utiliser pour des recherches à l'unité depuis votre application ou les outils de votre équipe.

ChampObligatoireDescription
first_nameOuiPrénom de la personne.
last_nameOuiNom de la personne.
domainOuiDomaine de l'entreprise, par exemple acme.com. Les URL sont normalisées par l'API.
cURL
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"}'
JSON
{
  "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
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.

CSV
first_name,last_name,domain
Jane,Doe,company.com
Sam,Lee,example.com
cURL
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

StatutSignificationFacturation
foundUn e-mail vérifié a été trouvé.Facturé
not_foundAucun e-mail nominatif vérifié n'a été trouvé.Non facturé
catch_allLe domaine accepte des adresses de manière large, la boîte de réception ne peut donc pas être confirmée.Non facturé
invalid_inputDes champs obligatoires (nom ou domaine) sont manquants.Non facturé
insufficient_creditsVotre compte ne dispose pas d'assez de crédits pour la capacité demandée.Non facturé