Skip to content

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")
>truefreemail.IsFree("mailinater.com")
>truefreemail.IsDisposable("gmail.com")
>falsefreemail.IsDisposable("mailinater.com")
>true

About

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

Resources

Stars

12 stars

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors

Languages