Docs/E-mail Finder

Email Finder API

Vind een geverifieerd zakelijk e-mailadres op basis van voornaam, achternaam en bedrijfsdomein.

Markdown bekijken OpenAPI JSON
Factureringsregel

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

  1. Jij stuurt first_name, last_name, en domain.
  2. VeriMails controleert de opgegeven naam en het domein op een geverifieerde persoonlijke mailbox.
  3. Een resultaat wordt pas teruggegeven na live verificatie.
  4. Kan een geverifieerde mailbox niet worden bevestigd, dan geeft de API dit terug: not_found of catch_all.
  5. Bij het opzoeken van personen geeft VeriMails een geverifieerd persoonlijk adres terug wanneer dat bevestigd kan worden.

Vind één e-mailadres

POST /api/find-email

Gebruik dit voor losse lookups vanuit je applicatie of teamtools.

VeldVerplichtBeschrijving
first_nameJaVoornaam van de persoon.
last_nameJaAchternaam van de persoon.
domainJaBedrijfsdomein, zoals acme.com. URL's worden door de API genormaliseerd.
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
}

Vind tot 100 e-mails synchroon

Gebruik het synchrone bulk-endpoint voor kleine batches. Grotere bestanden gaan via de CSV-flow hieronder.

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

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.

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

Aan de output-CSV wordt toegevoegd: found_email, finder_status, finder_confidence, en finder_elapsed_ms.

Statussen

StatusBetekenisFacturering
foundEr is een geverifieerd e-mailadres gevonden.Afgerekend
not_foundEr is geen geverifieerd persoonlijk e-mailadres gevonden.Geen kosten
catch_allHet domein accepteert brede adressen, dus de mailbox kan niet worden bevestigd.Geen kosten
invalid_inputVerplichte naam- of domeinvelden ontbreken.Geen kosten
insufficient_creditsJe account heeft niet genoeg credits voor de omvang van de aanvraag.Geen kosten