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/DNS, jetables, rôle et score de qualité. Le sondage SMTP est sur la feuille de route.
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 les domaines différents tournent en parallèle. Quand le sondage SMTP arrivera (il est sur la feuille de route), chaque domaine sera sondé une adresse à la fois — plus lent que de marteler un serveur, et ce qui garde nos IP 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, comparaison à la base des jetables et détection de rôle. Le sondage SMTP et la détection catch-all sont sur la feuille de route.
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
Combien de temps prend un traitement par lot ?
Cela dépend de la taille de la liste et du nombre de domaines distincts, car les requêtes DNS sont mises en cache par domaine. Quand le sondage SMTP arrivera (il est sur la feuille de route), nous sonderons une adresse à la fois par domaine de destination, et la répartition des domaines comptera davantage. Interrogez le traitement pour connaître la progression réelle plutôt que de travailler sur une estimation.
Quelle est la taille maximale d'un lot ?
L'endpoint batch accepte jusqu'à 500 000 adresses par traitement. Pour des listes plus grandes, envoyez plusieurs traitements. Chaque adresse compte pour une vérification sur votre quota mensuel.
Puis-je importer directement un fichier CSV ?
Oui — le tableau de bord accepte un fichier CSV, TSV ou texte, trouve la colonne contenant les adresses, retire les doublons et vous rend la liste nettoyée. L'API, elle, accepte un tableau JSON de chaînes.
Comment traiter les résultats « à risque » ?
La catégorie à risque regroupe les adresses de rôle, les domaines catch-all et les fournisseurs gratuits. Pour la prospection à froid : supprimez les adresses de rôle. Pour le marketing : gardez les fournisseurs gratuits (Gmail, Yahoo). Pour le catch-all, servez-vous du seuil de score — au-delà de 60, c'est en général sûr.
Prêt à l'intégrer ?
Choisissez l'offre adaptée à votre volume. Chaque compte inclut des clés de test pour votre CI.