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>"
}
'import requests
url = "https://api.linkupapi.com/v1/data/mail/finder"
payload = {
"linkedin_url": "<string>",
"first_name": "<string>",
"last_name": "<string>",
"company_domain": "<string>",
"company_name": "<string>"
}
headers = {
"x-api-key": "<x-api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'x-api-key': '<x-api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
linkedin_url: '<string>',
first_name: '<string>',
last_name: '<string>',
company_domain: '<string>',
company_name: '<string>'
})
};
fetch('https://api.linkupapi.com/v1/data/mail/finder', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.linkupapi.com/v1/data/mail/finder",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'linkedin_url' => '<string>',
'first_name' => '<string>',
'last_name' => '<string>',
'company_domain' => '<string>',
'company_name' => '<string>'
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"x-api-key: <x-api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.linkupapi.com/v1/data/mail/finder"
payload := strings.NewReader("{\n \"linkedin_url\": \"<string>\",\n \"first_name\": \"<string>\",\n \"last_name\": \"<string>\",\n \"company_domain\": \"<string>\",\n \"company_name\": \"<string>\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("x-api-key", "<x-api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.linkupapi.com/v1/data/mail/finder")
.header("x-api-key", "<x-api-key>")
.header("Content-Type", "application/json")
.body("{\n \"linkedin_url\": \"<string>\",\n \"first_name\": \"<string>\",\n \"last_name\": \"<string>\",\n \"company_domain\": \"<string>\",\n \"company_name\": \"<string>\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.linkupapi.com/v1/data/mail/finder")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["x-api-key"] = '<x-api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"linkedin_url\": \"<string>\",\n \"first_name\": \"<string>\",\n \"last_name\": \"<string>\",\n \"company_domain\": \"<string>\",\n \"company_name\": \"<string>\"\n}"
response = http.request(request)
puts response.read_body{
"status": "success",
"data": {
"email": "[email protected]",
"alternatives": ["[email protected]"],
"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"
}
}
}
{
"status": "success",
"data": {
"email": null,
"alternatives": [],
"catchall": false,
"domain_used": null,
"domains_tested": ["meta.com"],
"domains_filtered": ["meta.com"],
"companies_found": [
{
"name": "Meta",
"linkedin_url": "https://linkedin.com/company/meta",
"domain": "meta.com",
"is_current": true
}
],
"domains_extracted": ["meta.com"],
"person_info": {
"full_name": "Mark Zuckerberg",
"first_name": "Mark",
"last_name": "Zuckerberg",
"headline": "Founder and CEO at Meta",
"location": "Menlo Park, California"
}
}
}
Mail API
Email Finder
Find email address from LinkedIn profile URL
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>"
}
'import requests
url = "https://api.linkupapi.com/v1/data/mail/finder"
payload = {
"linkedin_url": "<string>",
"first_name": "<string>",
"last_name": "<string>",
"company_domain": "<string>",
"company_name": "<string>"
}
headers = {
"x-api-key": "<x-api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'x-api-key': '<x-api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
linkedin_url: '<string>',
first_name: '<string>',
last_name: '<string>',
company_domain: '<string>',
company_name: '<string>'
})
};
fetch('https://api.linkupapi.com/v1/data/mail/finder', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.linkupapi.com/v1/data/mail/finder",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'linkedin_url' => '<string>',
'first_name' => '<string>',
'last_name' => '<string>',
'company_domain' => '<string>',
'company_name' => '<string>'
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"x-api-key: <x-api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.linkupapi.com/v1/data/mail/finder"
payload := strings.NewReader("{\n \"linkedin_url\": \"<string>\",\n \"first_name\": \"<string>\",\n \"last_name\": \"<string>\",\n \"company_domain\": \"<string>\",\n \"company_name\": \"<string>\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("x-api-key", "<x-api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.linkupapi.com/v1/data/mail/finder")
.header("x-api-key", "<x-api-key>")
.header("Content-Type", "application/json")
.body("{\n \"linkedin_url\": \"<string>\",\n \"first_name\": \"<string>\",\n \"last_name\": \"<string>\",\n \"company_domain\": \"<string>\",\n \"company_name\": \"<string>\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.linkupapi.com/v1/data/mail/finder")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["x-api-key"] = '<x-api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"linkedin_url\": \"<string>\",\n \"first_name\": \"<string>\",\n \"last_name\": \"<string>\",\n \"company_domain\": \"<string>\",\n \"company_name\": \"<string>\"\n}"
response = http.request(request)
puts response.read_body{
"status": "success",
"data": {
"email": "[email protected]",
"alternatives": ["[email protected]"],
"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"
}
}
}
{
"status": "success",
"data": {
"email": null,
"alternatives": [],
"catchall": false,
"domain_used": null,
"domains_tested": ["meta.com"],
"domains_filtered": ["meta.com"],
"companies_found": [
{
"name": "Meta",
"linkedin_url": "https://linkedin.com/company/meta",
"domain": "meta.com",
"is_current": true
}
],
"domains_extracted": ["meta.com"],
"person_info": {
"full_name": "Mark Zuckerberg",
"first_name": "Mark",
"last_name": "Zuckerberg",
"headline": "Founder and CEO at Meta",
"location": "Menlo Park, California"
}
}
}
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
string
required
Your API key
Body Parameters
string
LinkedIn profile URL (e.g., https://www.linkedin.com/in/jeffbezos/)
Required if first_name and last_name are not provided
string
Person’s first name
Required if linkedin_url is not provided
string
Person’s last name
Required if linkedin_url is not provided
string
Company domain (e.g., “company.com”)
Recommended over company_name for better accuracy
string
Company name (will be used to find domain)
Less accurate than providing company_domain directly
Response
string
Request status (success/error)
object
Show Properties
Show Properties
string
Found email address
array
Array of alternative email addresses found
boolean
Whether the domain has catch-all email enabled
string
Primary domain used for the email
array
Array of domains that were tested
array
Array of domains after filtering
array
array
Array of domains extracted from profile analysis
{
"status": "success",
"data": {
"email": "[email protected]",
"alternatives": ["[email protected]"],
"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"
}
}
}
{
"status": "success",
"data": {
"email": null,
"alternatives": [],
"catchall": false,
"domain_used": null,
"domains_tested": ["meta.com"],
"domains_filtered": ["meta.com"],
"companies_found": [
{
"name": "Meta",
"linkedin_url": "https://linkedin.com/company/meta",
"domain": "meta.com",
"is_current": true
}
],
"domains_extracted": ["meta.com"],
"person_info": {
"full_name": "Mark Zuckerberg",
"first_name": "Mark",
"last_name": "Zuckerberg",
"headline": "Founder and CEO at Meta",
"location": "Menlo Park, California"
}
}
}
Notes
- You can use either a LinkedIn URL or provide first_name + last_name with company information
- Recommendation: Provide
company_domaindirectly instead ofcompany_namefor better accuracy and faster processing - If no email is found, the
emailfield will benull - The
catchallfield indicates if the domain accepts all email addresses - Alternative email addresses may be provided when multiple options are found
Was this page helpful?