find-email

Search for a person's email based on company and personal details.

Retrieves a specific person's email within a company. This search requires either "company_name" or "domain" to identify the company, and the person's name provided as "full_name" or both "first_name" and "last_name". For better results, we recommend using the company website (domain) instead of the company name. A "linkedin_url" can be sent on its own, in which case company and name are not needed.

post/v5.1/find-email/person

Request

  • Base URL: https://api.anymailfinder.com
  • URL: https://api.anymailfinder.com/v5.1/find-email/person
  • Auth: API key in header Authorization

Headers

x-webhook-urlstring

If provided, the result will be POSTed to this URL instead of waiting for the response.

Request body

company_namestring

Used if domain is not provided.

domainstring

Preferred. The company domain.

first_namestring

First name of the person.

full_namestring

Alternative to first+last name.

last_namestring

Last name of the person.

linkedin_urlstring

Optional LinkedIn profile URL. It can be sent on its own, without company and name. When a name and company are also provided, the profile is used to refine the supplied name (e.g. extending 'John D.' to 'John Doe'), and is used as a fallback if the name+company lookup doesn't return a verified email. The result may be at a different company/domain if the person has moved.

Example request

{
  "linkedin_url": "https://www.linkedin.com/in/satyanadella/"
}

Response

Email found.

inputobject required

Your request original input.

credits_chargednumber required

Number of credits charged for this request.

emailstring nullable required

The email found, or null if not found.

email_status'valid' | 'not_found' | 'blacklisted' required

The email status. One of the following: valid, not_found, blacklisted.

mx_domainstring nullable required

The root domain of the MX hostname, e.g. google.com or outlook.com. null when mx_host is null.

mx_hoststring nullable required

The domain's primary MX hostname, or null if no email was found.

person_company_namestring nullable required

Name of the company at which the returned email lives. Populated when email_status is valid, otherwise null.

person_full_namestring nullable required

Full name of the person we found the email for. May reflect a LinkedIn-extended version of the supplied name. Populated when email_status is valid, otherwise null.

person_job_titlestring nullable required

Job title of the person, sourced from LinkedIn. Populated when email_status is valid AND a LinkedIn URL was provided whose profile we successfully fetched. Otherwise null.

valid_emailstring nullable required

The email only when email_status is valid. Otherwise null.

Example response

{
  "email": "satyan@microsoft.com",
  "email_status": "valid",
  "mx_domain": "google.com",
  "mx_host": "aspmx.l.google.com",
  "person_company_name": "Microsoft",
  "person_full_name": "Satya Nadella",
  "person_job_title": "Chairman and CEO",
  "valid_email": "satyan@microsoft.com"
}

Changes

No recorded changes to this operation across all 1 revision of this API.