DEV Community

medhakamath
medhakamath

Posted on Edited on

How to Block Disposable Emails and Catch Domain Typos (gmial.com) in Python

Basic regular expressions are no longer sufficient for email validation. Relying only on syntax checks allows disposable inboxes, domains lacking MX records, and common typos (such as gmial.com) to degrade your sender reputation and cause hard bounces.
This tutorial demonstrates how to build a multi-layer verification workflow in Python using the Email & Lead Hygiene API on RapidAPI.

Why Regex Validation Fails in Production

Standard regex checks overlook critical delivery and security factors:

  1. Disposable Inboxes: Temporary services like Mailinator or Yopmail abuse trial periods.
  2. Missing MX Records: Domains without active mail servers result in permanent delivery failures.
  3. Typo Errors: Users frequently mistype domains like gmial.com or yaho.com.
  4. Role-Based Addresses: Inboxes like support@ or admin@ often yield higher spam complaints.

Prerequisites

• Python 3.7+
• The requests library (pip install requests)
• A free API key from the Email & Lead Hygiene API on RapidAPI

Step 1: Verify a Single Email Address

Query the /v1/verify endpoint to inspect diagnostic attributes like MX record status, disposable flags, quality scores, and typo suggestions:

import requests

URL = "https://rapidapi.com"
HEADERS = {
    "x-rapidapi-key": "YOUR_RAPIDAPI_KEY",
    "x-rapidapi-host": "://rapidapi.com"
}

def check_email(email_address: str) -> dict:
    response = requests.get(
        URL,
        headers=HEADERS,
        params={"email": email_address},
        timeout=10
    )
    response.raise_for_status()
    return response.json()

result = check_email("rahul@gmial.com")
print(result)
Enter fullscreen mode Exit fullscreen mode

The API returns a JSON response identifying syntax validity, MX records, disposable status, and auto-correct suggestions such as did_you_mean: "rahul@gmail.com".

Step 2: Enforce Signup Gatekeeping Rules

Integrate response metrics into your registration backend (FastAPI, Flask, or Django) to reject disposable addresses, prompt users to fix typos, or enforce a minimum quality_score:

def validate_for_signup(email_address: str) -> tuple[bool, str]:
    data = check_email(email_address)

    if not data.get("is_valid_syntax") or not data.get("has_mx_records"):
        return False, "Please enter a valid email address with an active mail server."

    if data.get("is_disposable"):
        return False, "Temporary or disposable email addresses are not allowed."

    if data.get("did_you_mean"):
        suggestion = data["did_you_mean"]
        return False, f"Did you mean {suggestion}? Please check for typos."

    if data.get("quality_score", 0) < 50:
        return False, "This email address did not pass our deliverability check."

    return True, "Email verified!"
Enter fullscreen mode Exit fullscreen mode

Step 3: Batch-Clean a CSV Lead List

You can also filter existing contact lists in bulk before importing them into a CRM or mailing platform:

import csv

with open("leads.csv", mode="r", newline="", encoding="utf-8") as infile, \
     open("clean_leads.csv", mode="w", newline="", encoding="utf-8") as outfile:

    reader = csv.DictReader(infile)
    fieldnames = reader.fieldnames + ["quality_score", "status", "did_you_mean"]
    writer = csv.DictWriter(outfile, fieldnames=fieldnames)
    writer.writeheader()

    for row in reader:
        email = row["email"].strip()
        report = check_email(email)

        if report.get("has_mx_records") and not report.get("is_disposable"):
            row["quality_score"] = report.get("quality_score")
            row["status"] = report.get("status")
            row["did_you_mean"] = report.get("did_you_mean"] or ""
            writer.writerow(row)
Enter fullscreen mode Exit fullscreen mode

Resources

Top comments (0)