Email Finder

This project is an email finder service written in Go. It provides an API to search for email addresses on a given domain based on a list of names for free.

Important

You must ensure that your ISP (cloud provider, coffee shop router, e.g.) does not block outbound traffic on port 25 for this to work. Most clouds I've tried do block it because of spammer's abuse, thus consider running this as a service from your home lab or make a deal with your ISP.

Features

• Email Generation: Generates potential email addresses from a list of names and a domain (Titles, UTF-8 and emoji aware).
• SMTP Verification: Checks the validity of generated email addresses using SMTP lookups.
• Catch-All Detection: Detects domains that have a "catch-all" email address configured.
• Common Email Search: Can search for common email addresses like info@..., hr@..., etc.
• Caching: Caches results to improve performance and avoid redundant checks.
• API: Exposes a simple JSON API for batch searches.

Usage

The service runs as a web server. To start it, run the main.go file in the cmd directory.

go run cmd/main.go

Then, you can send a POST request to the /v1/emails/batch-search endpoint with a JSON payload like this:

[
  {
    "domain": "example.com",
    "names": ["John Doe", "Jane Smith"],
    "includeCommonNames": true
  }
]

The service will return a JSON response with the found email addresses.