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.

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. By default 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. Set the optional include_all_emails property to true to also receive those non-consumer addresses. All returned addresses have email_type "personal". If the returned 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!/".

include_all_emailsboolean

When false (the default), only consumer-provider addresses (Gmail, Outlook, Yahoo, iCloud, Proton, and similar) are returned. When true, every strict email on record is returned, including corporate, educational and other custom domains. All returned addresses have email_type "personal".

Default:false
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",
    "include_all_emails": false
  }'

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" } ]