Skip to content
/ freemail Public
forked from willwhite/freemail

A database of free and disposable email domains and a golang module for querying it.

License

Notifications You must be signed in to change notification settings

dpup/freemail

 
 

Repository files navigation

go freemail

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.

Database

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.

Updating the database

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

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

About

A database of free and disposable email domains and a golang module for querying it.

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Go 100.0%