Documentazione/Trova Email

API Email Finder

Trova un'email professionale verificata a partire da nome, cognome e dominio aziendale.

Regola di addebito

Email Finder costa 20 crediti solo quando viene trovata un'email verificata. Nessun risultato verificato, input non valido e risultati catch-all non vengono addebitati. Le richieste in blocco e CSV richiedono crediti disponibili sufficienti per le email verificate che il job può restituire.

Come funziona

  1. Tu invii first_name, last_name, e domain.
  2. VeriMails controlla il nome e il dominio forniti alla ricerca di una casella verificata a livello di persona.
  3. Un risultato viene restituito solo dopo la verifica in tempo reale.
  4. Se non è possibile confermare una casella verificata, l'API restituisce not_found oppure catch_all.
  5. Per le ricerche di persone, VeriMails restituisce un indirizzo verificato a livello di persona quando è possibile confermarlo.

Trova un'email

POST /api/find-email

Usala per ricerche una alla volta dalla tua applicazione o dagli strumenti del tuo team.

CampoObbligatorioDescrizione
first_nameSìNome della persona.
last_nameSìCognome della persona.
domainSìDominio aziendale, ad esempio acme.com. Gli URL vengono normalizzati dall'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
}

Trova fino a 100 email in modo sincrono

Usa l'endpoint sincrono in blocco per piccoli batch. I file più grandi dovrebbero usare il flusso CSV qui sotto.

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

Email Finder da CSV

Carica un CSV quando devi trovare email su larga scala. Il CSV deve includere le colonne nome, cognome e dominio. Gli alias supportati includono firstname, lastname, company_domain, website, e 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

Il CSV in uscita aggiunge found_email, finder_status, finder_confidence, e finder_elapsed_ms.

Stati

StatoSignificatoFatturazione
foundÈ stata trovata un'email verificata.Addebitato
not_foundNon è stata trovata nessuna email personale verificata.Nessun addebito
catch_allIl dominio accetta indirizzi generici, quindi la casella non può essere confermata.Nessun addebito
invalid_inputMancano i campi obbligatori di nome o dominio.Nessun addebito
insufficient_creditsIl tuo account non ha crediti sufficienti per la capacità richiesta.Nessun addebito