Skip to content

Personal Emails

Retrieve personal email addresses for a known person. Returns addresses on free webmail / consumer providers (Gmail, Outlook, Yahoo, iCloud, Proton, and similar); corporate, educational, and other custom domains are excluded to keep deliverability high.

Operations

Personal emails lookup

Request

The Person Personal Emails Lookup endpoint retrieves personal email addresses associated with an individual in the Forager dataset. It allows you to input identifying information (such as Linkedin handle or Forager ID) and returns available personal contact emails. The endpoint returns only addresses on free webmail / consumer providers (Gmail, Outlook, Yahoo, iCloud, Proton, and similar). Addresses on corporate domains, educational domains (e.g., .edu, .ac.uk), and any other custom domains are excluded — including custom domains a person uses for personal purposes — to keep deliverability of the returned set high. If the filtered set is empty, the endpoint returns 200 OK with an empty body and does not consume credits.

Security
Api-Key
Path
account_idintegerrequired
Body
person_idinteger
linkedin_public_identifierstring

LinkedIn organization "Public identifier/Slug/ID" - "linkedin.com/in/!slug!/".

curl -i -X POST \
  'https://api-v2.forager.ai/api/{account_id}/datastorage/person_contacts_lookup/personal_emails/' \
  -H 'Content-Type: application/json' \
  -H 'X-API-KEY: YOUR_API_KEY_HERE' \
  -d '{
    "person_id": 0,
    "linkedin_public_identifier": "string"
  }'

Responses

Bodyapplication/json
Array [
emailstring, (email)read-onlyrequired
email_typestringread-onlyrequired
validation_statusstring(ValidationStatusEnum)read-onlyrequired
  • valid - Valid
  • risky - Risky
  • invalid - Invalid
  • unknown - Unknown
Enum:"valid""risky""invalid""unknown"
]
Response
[
  {
    "email": "user@example.com",
    "email_type": "string",
    "validation_status": "valid"
  }
]