API Email Finder
Trova un'email professionale verificata a partire da nome, cognome e dominio aziendale.
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
- Tu invii
first_name,last_name, edomain. - VeriMails controlla il nome e il dominio forniti alla ricerca di una casella verificata a livello di persona.
- Un risultato viene restituito solo dopo la verifica in tempo reale.
- Se non è possibile confermare una casella verificata, l'API restituisce
not_foundoppurecatch_all. - Per le ricerche di persone, VeriMails restituisce un indirizzo verificato a livello di persona quando è possibile confermarlo.
Trova un'email
Usala per ricerche una alla volta dalla tua applicazione o dagli strumenti del tuo team.
| Campo | Obbligatorio | Descrizione |
|---|---|---|
first_name | Sì | Nome della persona. |
last_name | Sì | Cognome della persona. |
domain | Sì | Dominio aziendale, ad esempio acme.com. Gli URL vengono normalizzati dall'API. |
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
}
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 -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.
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
Il CSV in uscita aggiunge found_email, finder_status, finder_confidence, e finder_elapsed_ms.
Stati
| Stato | Significato | Fatturazione |
|---|---|---|
found | È stata trovata un'email verificata. | Addebitato |
not_found | Non è stata trovata nessuna email personale verificata. | Nessun addebito |
catch_all | Il dominio accetta indirizzi generici, quindi la casella non può essere confermata. | Nessun addebito |
invalid_input | Mancano i campi obbligatori di nome o dominio. | Nessun addebito |
insufficient_credits | Il tuo account non ha crediti sufficienti per la capacità richiesta. | Nessun addebito |