API di verifica email in blocco
Invia fino a 500.000 indirizzi in una sola chiamata. Ricevi punteggi per indirizzo, classificazione dello stato e marcature di consegna, senza che la connessione scada.
Che cosa controlla Mailbeam
Ogni verifica esegue 7 controlli in parallelo e restituisce un risultato strutturato in meno di 100 ms.
500.000 indirizzi per lavoro
Un unico POST a /v1/verify/batch accetta fino a 500.000 indirizzi email. I lavori vengono messi in coda ed elaborati in modo asincrono: niente timeout HTTP, niente risultati parziali.
Webhook firmato al completamento
Registra un endpoint una volta nella dashboard. Quando un lavoro finisce, Mailbeam invia in POST un evento batch.completed con i totali e un URL di download, firmato in HMAC-SHA256 perché tu possa verificare che venga da noi.
Punteggio per indirizzo
Ogni indirizzo del lotto riceve lo stesso trattamento dell'endpoint di verifica singola: sintassi, MX, SMTP, usa e getta, ruolo, rilevamento catch-all e punteggio di qualità.
Segmentazione recapitabile / rischioso / non recapitabile
I risultati includono un campo di stato per indirizzo. Filtra l'output JSON per stato per creare segmenti pronti all'invio, di revisione e di soppressione.
Interrogazione dell'avanzamento
Interroga /v1/jobs/{jobId} in qualsiasi momento per sapere quanti indirizzi sono stati elaborati. Oppure aspetta semplicemente il webhook: quello che si adatta meglio al tuo flusso.
Una connessione per dominio di destinazione
Gli indirizzi vengono raggruppati per dominio e ogni dominio viene sondato uno alla volta, mentre domini diversi vanno in parallelo. È più lento che martellare un server di posta, ed è ciò che tiene i nostri IP — e quindi i tuoi risultati — fuori dalle blocklist.
Come funziona
Fai POST dell'array di email
Invia un corpo JSON con un array `emails` — fino a 500.000 stringhe — a /v1/verify/batch. La risposta restituisce subito un `job_id`, con un 202.
Inizia l'elaborazione asincrona
Mailbeam elabora ogni indirizzo in modo indipendente: controllo della sintassi, query DNS/MX, sondaggio SMTP, confronto con il database degli usa e getta, rilevamento del ruolo e punteggio catch-all.
Scatta il webhook (o interroghi tu)
Quando tutti gli indirizzi sono stati elaborati, il tuo endpoint riceve un evento `batch.completed` firmato. In alternativa, interroga l'avanzamento su /v1/jobs/{jobId}.
Recupera e segmenta i risultati
Scarica /v1/jobs/{jobId}/results in CSV, o aggiungi ?format=json per ottenere righe con `index`, `email`, `status`, `score` e `reason`. Filtra per stato per costruire i tuoi segmenti. I risultati restano 72 ore e poi vengono cancellati.
Integralo in pochi minuti
const auth = { Authorization: `Bearer ${process.env.MAILBEAM_KEY}` };
// Crea un lavoro in blocco: restituisce subito un 202
const job = await fetch("https://api.mailbeam.dev/v1/verify/batch", {
method: "POST",
headers: { ...auth, "Content-Type": "application/json" },
body: JSON.stringify({
emails: ["alice@example.com", "bob@company.io" /* fino a 500.000 */],
}),
}).then((r) => r.json());
console.log(`Lavoro ${job.job_id} in coda — ${job.total} indirizzi`);
// Aspetta il webhook batch.completed, oppure interroga:
const status = await fetch(
`https://api.mailbeam.dev/v1/jobs/${job.job_id}`,
{ headers: auth }
).then((r) => r.json());
// Poi scarica la lista pulita (CSV per impostazione predefinita)
const csv = await fetch(status.download_url, { headers: auth }).then((r) =>
r.text()
);Quando usarlo
Pulizia delle liste prima di una campagna
Passa tutte le tue liste nell'API batch prima di inviare una campagna. Sopprimi gli indirizzi non recapitabili per tenere il bounce sotto la soglia del 2% dei provider.
Validazione degli import nel CRM
Verifica i contatti prima di importarli da esportazioni di fiere, fogli di calcolo o fonti di lead di terze parti. Nel CRM entrano dati puliti; i non validi non entrano mai.
Riverifica trimestrale del database
Gli indirizzi B2B si degradano di circa il 25% l'anno. Programma un lavoro in blocco trimestrale sulla tua intera base di utenti o contatti per individuare quelli scaduti.
Preparazione delle campagne di riattivazione
I segmenti inattivi sono quelli che si degradano di più. Verifica prima di qualsiasi invio di recupero per sopprimere gli indirizzi non validi ed evitare il danno di recapitabilità che i bounce provocano.
Domande frequenti
Pronto a integrarlo?
Il piano gratuito include 1.000 verifiche al mese. Senza carta di credito.