Email Finder API
Finde eine verifizierte berufliche E-Mail anhand von Vorname, Nachname und Firmen-Domain.
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
- Du sendest
first_name,last_nameunddomain. - VeriMails prüft den angegebenen Namen und die Domain auf ein verifiziertes persönliches Postfach.
- Ein Ergebnis wird erst nach einer Live-Verifizierung zurückgegeben.
- Lässt sich kein verifiziertes Postfach bestätigen, liefert die API
not_foundodercatch_all. - Bei Personensuchen liefert VeriMails eine verifizierte persönliche Adresse, wenn sie sich bestätigen lässt.
Eine E-Mail finden
Nutze das für Einzelabfragen aus deiner Anwendung oder deinen Team-Tools.
| Feld | Pflichtfeld | Beschreibung |
|---|---|---|
first_name | Ja | Vorname der Person. |
last_name | Ja | Nachname der Person. |
domain | Ja | Firmen-Domain, zum Beispiel acme.com. URLs werden von der API normalisiert. |
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
}
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 -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.
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
Die Ausgabe-CSV ergänzt found_email, finder_status, finder_confidence und finder_elapsed_ms.
Status
| Status | Bedeutung | Abrechnung |
|---|---|---|
found | Eine verifizierte E-Mail wurde gefunden. | Berechnet |
not_found | Es wurde keine verifizierte personenbezogene E-Mail gefunden. | Keine Kosten |
catch_all | Die Domain akzeptiert beliebige Adressen, daher lässt sich das Postfach nicht bestätigen. | Keine Kosten |
invalid_input | Pflichtfelder für Name oder Domain fehlen. | Keine Kosten |
insufficient_credits | Dein Account hat nicht genug Credits für den Umfang der Anfrage. | Keine Kosten |