Docs/E-Mail-Finder

Email Finder API

Finde eine verifizierte berufliche E-Mail anhand von Vorname, Nachname und Firmen-Domain.

Markdown ansehen OpenAPI JSON
Abrechnungsregel

Der Email Finder kostet 20 Credits, und zwar nur, wenn eine verifizierte E-Mail gefunden wird. Kein verifizierter Treffer, ungültige Eingaben und Catch-all-Ergebnisse werden nicht berechnet. Bulk- und CSV-Anfragen brauchen genug aktuelles Guthaben für die verifizierten E-Mails, die der Job liefern kann.

So funktioniert's

  1. Du sendest first_name, last_name und domain.
  2. VeriMails prüft den angegebenen Namen und die Domain auf ein verifiziertes persönliches Postfach.
  3. Ein Ergebnis wird erst nach einer Live-Verifizierung zurückgegeben.
  4. Lässt sich kein verifiziertes Postfach bestätigen, liefert die API not_found oder catch_all.
  5. Bei Personensuchen liefert VeriMails eine verifizierte persönliche Adresse, wenn sie sich bestätigen lässt.

Eine E-Mail finden

POST /api/find-email

Nutze das für Einzelabfragen aus deiner Anwendung oder deinen Team-Tools.

FeldPflichtfeldBeschreibung
first_nameJaVorname der Person.
last_nameJaNachname der Person.
domainJaFirmen-Domain, zum Beispiel acme.com. URLs werden von der API normalisiert.
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
}

Bis zu 100 E-Mails synchron finden

Nutze den synchronen Bulk-Endpunkt für kleine Batches. Größere Dateien sollten den CSV-Ablauf unten nutzen.

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"}
    ]
  }'

CSV Email Finder

Lade eine CSV hoch, wenn du E-Mails in großem Umfang finden willst. Die CSV muss Spalten für Vorname, Nachname und Domain enthalten. Unterstützte Aliase sind unter anderem firstname, lastname, company_domain, website und 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

Die Ausgabe-CSV ergänzt found_email, finder_status, finder_confidence und finder_elapsed_ms.

Status

StatusBedeutungAbrechnung
foundEine verifizierte E-Mail wurde gefunden.Berechnet
not_foundEs wurde keine verifizierte personenbezogene E-Mail gefunden.Keine Kosten
catch_allDie Domain akzeptiert beliebige Adressen, daher lässt sich das Postfach nicht bestätigen.Keine Kosten
invalid_inputPflichtfelder für Name oder Domain fehlen.Keine Kosten
insufficient_creditsDein Account hat nicht genug Credits für den Umfang der Anfrage.Keine Kosten