disposable

README

🗑 Disposable email domains

A collection of domains for disposable email services like 10MinuteMail and GuerrillaMail. Also, some 🛠 to make your life easier.

Contributions

If you are already familiar with the topic or have good suggestions for automating the crawling processes, feel free to open an issue. We are also looking for people to maintain this project or implement additional pages.

Why?

Use it to validate email addresses on sign up, or just to see how many real email addresses you have in your system.

Usage

List

A file containing a sorted list of domains, one per line.

curl https://raw.githubusercontent.com/disposable/disposable-email-domains/master/domains.txt

JSON array

A file containing a sorted array of domains, in JSON format.

curl https://raw.githubusercontent.com/disposable/disposable-email-domains/master/domains.json

JavaScript

Install the npm package disposable-email. Validate synchronously or with a callback.

npm i --save disposable-email

var disposable = require('disposable-email');

disposable.validate('gmail.com');
// true

disposable.validate('foo@gmail.com');
// true

disposable.validate('gmail.com', console.log);
// undefined
// null true

Go

import "github.com/disposable/disposable"

if disposable.Domain("gmail.com") {
    panic("Uh oh!")
}

Java

Checkout ZliIO/zliio-disposable - thanks @ZliIO for the implementation in Java.

Update the list of domains

To update the list of domains run .generate (requires python3), and optionally submit a PR.

$ ./.generate
Fetched 5196 domains and 6593 hashes
 - 2000 domain(s) added
 - 75 domain(s) removed
 - 2010 hash(es) added
 - 76 hash(es) removed

External Sources:

Source	Status
https://gist.github.com/adamloving/4401361/
https://gist.github.com/jamesonev/7e188c35fd5ca754c970e3a1caf045ef/
https://github.com/disposable/static-disposable-lists/
https://github.com/wesbos/burner-email-providers/
https://github.com/stopforumspam/disposable_email_domains/
https://github.com/martenson/disposable-email-domains/
https://github.com/daisy1754/jp-disposable-emails/
https://github.com/FGRibreau/mailchecker/
https://github.com/ivolo/disposable-email-domains/
https://github.com/7c/fakefilter/
https://github.com/flotwig/disposable-email-addresses/
https://www.rotvpn.com/en/disposable-email

Credits

@adamloving @michenriksen @ivolo @smeinecke @GeroldSetz @martenson @FGRibreau @daisy1754 @jamesonev @wesbos @willwhite @stopforumspam @7c @copini @ZliIO

CDN

• Production: https://rawcdn.githack.com/disposable/disposable-email-domains/master/domains.json
• Development: https://raw.githack.com/disposable/disposable-email-domains/master/domains.json

by: https://raw.githack.com/

Documentation

Index

• func Domain(d string) bool
• func DomainMap() map[string]struct{}

Functions

func Domain

func Domain(d string) bool

Domain tests whether a string is among the known set of disposable mailboxes

func DomainMap

func DomainMap() map[string]struct{}

DomainMap returns all known domains in form of a map (for O(1)-ish search)