API de détection des adresses de rôle
Une boîte partagée comme info@ ou sales@ n'est pas une personne. Signalez-la à la collecte pour filtrer les inscriptions, ajuster vos scores de leads ou l'exclure des envois à froid.
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.
Base de préfixes de rôle curée
Comparaison à une liste tenue à jour de préfixes — info, admin, support, sales, billing, noreply et des dizaines d'autres — normalisés pour l'adressage avec + (info+tag@).
Un booléen, plus le contexte
La réponse porte role: true et exécute quand même tous les autres contrôles : vous gardez le verdict de délivrabilité complet plutôt qu'un simple oui/non.
Consciente de l'adressage avec +
info+newsletter@ est correctement identifiée comme l'adresse de rôle info@, et non traitée comme une boîte personnelle unique.
Préfixes localisés
Reconnaît les préfixes de rôle courants hors anglais (kontakt@, ventas@, contato@) pour que les listes internationales ne soient pas sous-signalées.
Application réglable
Les adresses de rôle sont signalées, pas rejetées d'office — à vous de décider de bloquer, de router vers le commercial, ou simplement de baisser le score.
Un seul appel, en ligne
La détection fait partie de la même réponse /v1/verify : aucune requête ni latence supplémentaire dans votre flux.
Comment ça marche
POSTez l'adresse
Envoyez l'e-mail à /v1/verify. La détection de rôle tourne aux côtés des contrôles de syntaxe, MX, SMTP et jetables.
La partie locale est normalisée
Ce qui précède le @ est mis en minuscules et débarrassé de l'adressage +tag avant comparaison.
Comparaison à la base de préfixes
La partie locale normalisée est confrontée à l'ensemble de préfixes de rôle tenu à jour, variantes localisées comprises.
L'indicateur revient dans le résultat
role: true|false figure dans le JSON, à côté du statut et du score, pour que vous branchiez dessus dans votre code.
Intégrez-le en quelques minutes
const res = await fetch("https://api.mailbeam.dev/v1/verify", {
method: "POST",
headers: { Authorization: `Bearer ${process.env.MAILBEAM_KEY}` },
body: JSON.stringify({ email }),
});
const { role, status } = await res.json();
if (role) {
routeToSalesAssist(email); // boîte partagée — pas de libre-service
} else if (status === "deliverable") {
allowSelfServeSignup(email);
}Quand l'utiliser
Filtrage des inscriptions B2B
Routez les inscriptions info@ et admin@ vers un parcours accompagné plutôt qu'en libre-service, où une boîte partagée convertit rarement.
Exclusion en prospection à froid
Supprimez les adresses de rôle avant un envoi à froid : elles génèrent des plaintes et appartiennent rarement à un décideur unique.
Scoring des leads
Pondérez à la baisse les adresses de rôle dans votre modèle, puisqu'elles signalent une boîte partagée et non un acheteur identifié.
Segmentation de liste
Séparez les adresses personnelles des adresses de service pour adresser à chacune le bon message.
Questions fréquentes
Prêt à l'intégrer ?
L'offre gratuite inclut 1 000 vérifications par mois. Sans carte bancaire.