POST
/
v1
/
data
/
mail
/
finder
Email Finder
curl --request POST \
  --url https://api.linkupapi.com/v1/data/mail/finder \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <x-api-key>' \
  --data '{
  "linkedin_url": "<string>",
  "first_name": "<string>",
  "last_name": "<string>",
  "company_domain": "<string>",
  "company_name": "<string>"
}'
{
  "status": "success",
  "data": {
    "email": "jeff@amazon.com",
    "alternatives": ["jbezos@amazon.com"],
    "catchall": false,
    "domain_used": "amazon.com",
    "domains_tested": ["amazon.com", "blueorigin.com"],
    "domains_filtered": ["amazon.com"],
    "companies_found": [
      {
        "name": "Amazon",
        "linkedin_url": "https://linkedin.com/company/amazon",
        "domain": "amazon.com",
        "is_current": false
      },
      {
        "name": "Blue Origin",
        "linkedin_url": "https://linkedin.com/company/blue-origin",
        "domain": "blueorigin.com",
        "is_current": true
      }
    ],
    "domains_extracted": ["amazon.com", "blueorigin.com"],
    "person_info": {
      "full_name": "Jeff Bezos",
      "first_name": "Jeff",
      "last_name": "Bezos",
      "headline": "Executive Chairman at Amazon, Founder of Blue Origin",
      "location": "Seattle, Washington, United States"
    }
  }
}
Find the email address associated with a LinkedIn profile. This endpoint analyzes the LinkedIn profile and attempts to find the professional email address.
This endpoint costs 1 credit per request.

Header Parameters

x-api-key
string
required
Your API key

Body Parameters

linkedin_url
string
LinkedIn profile URL (e.g., https://www.linkedin.com/in/jeffbezos/) Required if first_name and last_name are not provided
first_name
string
Person’s first name Required if linkedin_url is not provided
last_name
string
Person’s last name Required if linkedin_url is not provided
company_domain
string
Company domain (e.g., “company.com”) Recommended over company_name for better accuracy
company_name
string
Company name (will be used to find domain) Less accurate than providing company_domain directly

Response

status
string
Request status (success/error)
data
object
{
  "status": "success",
  "data": {
    "email": "jeff@amazon.com",
    "alternatives": ["jbezos@amazon.com"],
    "catchall": false,
    "domain_used": "amazon.com",
    "domains_tested": ["amazon.com", "blueorigin.com"],
    "domains_filtered": ["amazon.com"],
    "companies_found": [
      {
        "name": "Amazon",
        "linkedin_url": "https://linkedin.com/company/amazon",
        "domain": "amazon.com",
        "is_current": false
      },
      {
        "name": "Blue Origin",
        "linkedin_url": "https://linkedin.com/company/blue-origin",
        "domain": "blueorigin.com",
        "is_current": true
      }
    ],
    "domains_extracted": ["amazon.com", "blueorigin.com"],
    "person_info": {
      "full_name": "Jeff Bezos",
      "first_name": "Jeff",
      "last_name": "Bezos",
      "headline": "Executive Chairman at Amazon, Founder of Blue Origin",
      "location": "Seattle, Washington, United States"
    }
  }
}

Notes

  • You can use either a LinkedIn URL or provide first_name + last_name with company information
  • Recommendation: Provide company_domain directly instead of company_name for better accuracy and faster processing
  • If no email is found, the email field will be null
  • The catchall field indicates if the domain accepts all email addresses
  • Alternative email addresses may be provided when multiple options are found