Skip to content

README.md

Latest commit

 

History

History
87 lines (59 loc) · 3.84 KB

README.md

File metadata and controls

87 lines (59 loc) · 3.84 KB
Raw

Real-time Disposable Email Domains

All Flagged Domains Flagged Root Domains Active Domains

This project automatically aggregates disposable email domains using curated public lists, third-party sources, and internally collected intelligence. All ingestion, validation, and publishing workflows are fully automated. All domains are normalised and validated before inclusion.

Repository Structure

├── data/
│   ├── domains.txt      # All flagged disposable domains (includes subdomains)
│   ├── root.txt         # Flagged disposable root domains
│   ├── active.txt       # Flagged root domains with active MX records
│   ├── domains.raw.txt  # domains.txt without comments
│   ├── root.raw.txt     # root.txt without comments
│   └── active.raw.txt   # active.txt without comments
│
├── domain_whitelist.txt      # Manual domain whitelist
└── tld_whitelist.txt         # Manual TLD whitelist

Accessing the data

You can access the data with any CDN provider you want however you can access the data easiest with the provided github pages below:

https://dmails.doodadlabs.org/data/domains.txt
https://dmails.doodadlabs.org/data/root.txt
https://dmails.doodadlabs.org/data/active.txt

# comment free lists
https://dmails.doodadlabs.org/data/domains.raw.txt
https://dmails.doodadlabs.org/data/root.raw.txt
https://dmails.doodadlabs.org/data/active.raw.txt

Data Update Frequency

The dataset is continuously maintained:

  • data/domains.txt is updated every hour
  • data/root.txt is updated every hour
  • data/active.txt is updated once per day

active.txt contains only domains that currently resolve with a valid MX record.

Reporting Incorrectly Flagged Domains

If you believe a legitimate domain has been incorrectly classified as disposable, you can help improve accuracy by contributing to the whitelist.

To contribute:

  1. Confirm that the domain provides a legitimate, non-disposable email service
  2. Add the domain to domain_whitelist.txt, or add a TLD to tld_whitelist.txt
  3. Submit a pull request

The allow list acts as a manual override to prevent false positives.

Data Sources

Domains are sourced from:

  • established public disposable email domain lists
  • open-source intelligence feeds
  • internal discovery and monitoring systems
  • community contributions

Sources are aggregated, cleaned, validated, and standardised before publication.

Contributions

Although the project is automatically maintained through scraping and aggregation, domain ecosystems change frequently. Providers appear, disappear, and repurpose infrastructure.

Community input is essential to:

  • reduce false positives
  • identify new disposable providers
  • maintain data freshness
  • improve validation logic

First-time contributors are welcome. Even small corrections significantly improve dataset reliability.

Every contribution directly strengthens the integrity and usefulness of this resource.