Skip to content
Gridlode
Docs · Reference

Email Finder

GET /v1/contacts/email-finder5 credits / requestcache 1440 min

Likely work email addresses for a person at a company, from their name and the company domain. Checks that the domain receives mail (MX records and mail provider), reads the company website for published addresses, infers the company's address pattern from them (first.last, flast, first, firstl, f.last, last, first_last ...) and returns ranked candidates with a confidence score and the evidence behind each one, including whether the exact address appears on the website. Mailboxes are never probed over SMTP, so catch-all status stays unknown.

Query parameters

first_name
string
Given name, e.g. Jane.
Default: null
last_name
string
Family name, e.g. Doe.
Default: null
full_name
string
Full name instead of first_name + last_name, e.g. 'Jane Doe' or 'Doe, Jane'.
Default: null
domain
string · required
Company domain (or website URL), e.g. acme.com.
check_website
boolean
Read the company website (home page plus up to max_pages-1 contact/about/imprint pages) for published addresses.
Default: true
max_pages
integer
Website pages to read when check_website is on.
Default: 4
respect_robots
boolean
Skip website pages disallowed by robots.txt.
Default: true
max_candidates
integer
How many ranked addresses to return.
Default: 6
max_age
integer
Accept a cached answer up to this many seconds old, billed at 50%.

Response data fields

    Example

    curl "https://api.gridlode.com/v1/contacts/email-finder?first_name=Jane&last_name=Sample&domain=python.org&max_pages=2" \
  -H "Authorization: Bearer $GRIDLODE_KEY"

    Try it without code on the Email Finder API page.