Email Finder API
Vind een geverifieerd zakelijk e-mailadres op basis van voornaam, achternaam en bedrijfsdomein.
Email Finder kost alleen 20 credits als er een geverifieerd e-mailadres gevonden wordt. Geen geverifieerde treffer, ongeldige invoer en catch-all-resultaten worden niet in rekening gebracht. Voor bulk- en CSV-requests heb je genoeg actuele credits nodig voor de geverifieerde e-mails die de job kan opleveren.
Zo werkt het
- Jij stuurt
first_name,last_name, endomain. - VeriMails controleert de opgegeven naam en het domein op een geverifieerde persoonlijke mailbox.
- Een resultaat wordt pas teruggegeven na live verificatie.
- Kan een geverifieerde mailbox niet worden bevestigd, dan geeft de API dit terug:
not_foundofcatch_all. - Bij het opzoeken van personen geeft VeriMails een geverifieerd persoonlijk adres terug wanneer dat bevestigd kan worden.
Vind één e-mailadres
Gebruik dit voor losse lookups vanuit je applicatie of teamtools.
| Veld | Verplicht | Beschrijving |
|---|---|---|
first_name | Ja | Voornaam van de persoon. |
last_name | Ja | Achternaam van de persoon. |
domain | Ja | Bedrijfsdomein, zoals acme.com. URL's worden door de API genormaliseerd. |
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
}
Vind tot 100 e-mails synchroon
Gebruik het synchrone bulk-endpoint voor kleine batches. Grotere bestanden gaan via de CSV-flow hieronder.
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
Upload een CSV wanneer je e-mailadressen op schaal wilt vinden. De CSV moet kolommen bevatten voor voornaam, achternaam en domein. Ondersteunde aliassen zijn onder andere firstname, lastname, company_domain, website, en 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
Aan de output-CSV wordt toegevoegd: found_email, finder_status, finder_confidence, en finder_elapsed_ms.
Statussen
| Status | Betekenis | Facturering |
|---|---|---|
found | Er is een geverifieerd e-mailadres gevonden. | Afgerekend |
not_found | Er is geen geverifieerd persoonlijk e-mailadres gevonden. | Geen kosten |
catch_all | Het domein accepteert brede adressen, dus de mailbox kan niet worden bevestigd. | Geen kosten |
invalid_input | Verplichte naam- of domeinvelden ontbreken. | Geen kosten |
insufficient_credits | Je account heeft niet genoeg credits voor de omvang van de aanvraag. | Geen kosten |