A database of free and disposable email domains and a handy Go module for querying it.
Use the Go module or access the files in the ./data
directory and parse with your language of choice. For Node.js see the original implementation.
There are three key data files in this project:
- free.txt contains a list of domains that are known to provide free email service.
- disposable.txt contains a list of domains that are known to provide disposable email service.
- spammy.txt contains a list of domains that Stop Forum Spam report as toxic and abusive.
Domains may only be a member of one list.
Run ./update
to pull in the latest domains from the free sources listed in sources.txt
. These domains will be placed in free.txt
. Disposable emails from ivolo/disposable-email-domains will be added to disposable.txt
. Spammy emails from Stop Forum Spam will be added to spammy.txt
.
Then run go generate
.
go get github.com/dpup/freemail
import "github.com/dpup/freemail"
freemail.IsFree("gmail.com")
> true
freemail.IsFree("mailinater.com")
> true
freemail.IsDisposable("gmail.com")
> false
freemail.IsDisposable("mailinater.com")
> true