API de vérification d'e-mails en masse
Envoyez jusqu'à 500 000 adresses en un seul appel d'API. Récupérez un score, une classification de statut et des indicateurs de livraison par adresse — sans expiration de connexion.
Ce que Mailbeam contrôle
Chaque vérification lance 7 contrôles en parallèle et renvoie un résultat structuré en moins de 100 ms.
500 000 adresses par traitement
Un seul POST vers /v1/verify/batch accepte jusqu'à 500 000 adresses e-mail. Les traitements sont mis en file et exécutés en asynchrone — pas de timeout HTTP, pas de résultats partiels.
Webhook signé à la fin
Déclarez un endpoint une fois dans le tableau de bord. À la fin d'un traitement, Mailbeam envoie en POST un événement batch.completed portant les totaux et une URL de téléchargement, signé en HMAC-SHA256 pour que vous puissiez vérifier qu'il vient de nous.
Un score par adresse
Chaque adresse du lot reçoit le même traitement que sur l'endpoint verify unitaire : syntaxe, MX, SMTP, jetables, rôle, détection catch-all et score de qualité.
Segmentation délivrable / à risque / non délivrable
Les résultats contiennent un champ de statut par adresse. Filtrez la sortie JSON par statut pour créer vos segments prêts à l'envoi, à examiner et à supprimer.
Suivi de progression
Interrogez /v1/jobs/{jobId} à tout moment pour connaître le nombre d'adresses déjà traitées. Ou attendez simplement le webhook — au choix, selon votre flux.
Une connexion par domaine de destination
Les adresses sont regroupées par domaine et chaque domaine est sondé une adresse à la fois, tandis que les domaines différents tournent en parallèle. C'est plus lent que de marteler un serveur, et c'est ce qui garde nos IP — et donc vos résultats — hors des listes de blocage.
Comment ça marche
POSTez le tableau d'adresses
Envoyez un corps JSON avec un tableau `emails` — jusqu'à 500 000 chaînes — vers /v1/verify/batch. La réponse renvoie immédiatement un `job_id`, avec un 202.
Le traitement asynchrone démarre
Mailbeam traite chaque adresse indépendamment : contrôle de syntaxe, requête DNS/MX, sondage SMTP, comparaison à la base des jetables, détection de rôle et score catch-all.
Le webhook part (ou vous interrogez)
Quand toutes les adresses ont été traitées, votre endpoint reçoit un événement signé `batch.completed`. Vous pouvez sinon interroger /v1/jobs/{jobId} pour suivre la progression.
Récupérez et segmentez les résultats
Téléchargez /v1/jobs/{jobId}/results en CSV, ou ajoutez ?format=json pour des lignes portant `index`, `email`, `status`, `score` et `reason`. Filtrez par statut pour construire vos segments. Les résultats sont conservés 72 heures, puis supprimés.
Intégrez-le en quelques minutes
const auth = { Authorization: `Bearer ${process.env.MAILBEAM_KEY}` };
// Envoi d'un traitement par lot — renvoie 202 immédiatement
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" /* jusqu'à 500 000 */],
}),
}).then((r) => r.json());
console.log(`Traitement ${job.job_id} en file — ${job.total} adresses`);
// Attendez le webhook batch.completed, ou interrogez :
const status = await fetch(
`https://api.mailbeam.dev/v1/jobs/${job.job_id}`,
{ headers: auth }
).then((r) => r.json());
// Puis téléchargez la liste nettoyée (CSV par défaut)
const csv = await fetch(status.download_url, { headers: auth }).then((r) =>
r.text()
);Quand l'utiliser
Nettoyage de liste avant campagne
Passez chaque liste par l'API batch avant d'envoyer une campagne. Supprimez les adresses non délivrables pour garder le taux de bounce sous le seuil de 2 % des FAI.
Validation des imports CRM
Vérifiez les contacts avant de les importer depuis des exports de salons, des tableurs ou des sources de leads tierces. Les données propres entrent dans votre CRM ; les mauvaises n'y entrent jamais.
Revérification trimestrielle de la base
Les adresses B2B se dégradent d'environ 25 % par an. Planifiez un traitement trimestriel sur toute votre base d'utilisateurs ou de contacts pour repérer celles qui ont expiré.
Préparation d'une campagne de réengagement
Les segments inactifs ont le plus fort taux de dégradation. Vérifiez avant tout envoi de reconquête pour supprimer les adresses invalides et éviter les dégâts de délivrabilité liés aux bounces.
Questions fréquentes
Prêt à l'intégrer ?
L'offre gratuite inclut 1 000 vérifications par mois. Sans carte bancaire.