Reverse Email Lookup
curl --request POST \
--url https://api.linkupapi.com/v2/enrich \
--header 'Content-Type: application/json' \
--data '
{
"action": "<string>",
"params": {
"email": "<string>"
}
}
'import requests
url = "https://api.linkupapi.com/v2/enrich"
payload = {
"action": "<string>",
"params": { "email": "<string>" }
}
headers = {"Content-Type": "application/json"}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'Content-Type': 'application/json'},
body: JSON.stringify({action: '<string>', params: {email: '<string>'}})
};
fetch('https://api.linkupapi.com/v2/enrich', 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/v2/enrich",
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([
'action' => '<string>',
'params' => [
'email' => '<string>'
]
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json"
],
]);
$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/v2/enrich"
payload := strings.NewReader("{\n \"action\": \"<string>\",\n \"params\": {\n \"email\": \"<string>\"\n }\n}")
req, _ := http.NewRequest("POST", url, payload)
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/v2/enrich")
.header("Content-Type", "application/json")
.body("{\n \"action\": \"<string>\",\n \"params\": {\n \"email\": \"<string>\"\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.linkupapi.com/v2/enrich")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n \"action\": \"<string>\",\n \"params\": {\n \"email\": \"<string>\"\n }\n}"
response = http.request(request)
puts response.read_body{
"success": true,
"data": {
"email_parsed": {
"original_email": "jane.doe@acme-corp.com",
"first_name": "Jane",
"last_name": "Doe",
"company_domain": "acme-corp.com",
"parsing_confidence": "high"
},
"person_found": {
"full_name": "Jane Doe",
"first_name": "Jane",
"last_name": "Doe",
"headline": "Senior Product Manager at Acme Corp",
"location": "San Francisco Bay Area",
"industry": "Computer Software",
"profile_url": "https://www.linkedin.com/in/jane-doe-42",
"experience": [
{
"company": "Acme Corp",
"title": "Senior Product Manager",
"start_date": "1/2023",
"end_date": ""
}
]
}
},
"metadata": {
"action": "reverse_email",
"credits_consumed": 1,
"timestamp": "2026-04-26T10:35:00Z"
}
}
{
"success": true,
"data": {
"email_parsed": {
"original_email": "j.doe@small-shop.io",
"first_name": "John",
"last_name": "Doe",
"company_domain": "small-shop.io",
"parsing_confidence": "medium"
},
"person_found": {
"full_name": "John Doe",
"first_name": "John",
"last_name": "Doe"
}
},
"metadata": {
"action": "reverse_email",
"credits_consumed": 1,
"timestamp": "2026-04-26T10:35:00Z"
}
}
{
"success": false,
"error": {
"code": "INVALID_PARAMS",
"message": "Only professional email addresses are accepted. Personal email providers (Gmail, Yahoo, Hotmail, etc.) are not supported."
},
"metadata": {
"action": "reverse_email",
"credits_consumed": 0,
"timestamp": "2026-04-26T10:35:00Z"
}
}
{
"success": false,
"error": {
"code": "INVALID_PARAMS",
"message": "Invalid email format"
},
"metadata": {
"action": "reverse_email",
"credits_consumed": 0,
"timestamp": "2026-04-26T10:35:00Z"
}
}
Email Enrichment
Reverse Email Lookup
Identify a person from their professional email address.
POST
/
v2
/
enrich
Reverse Email Lookup
curl --request POST \
--url https://api.linkupapi.com/v2/enrich \
--header 'Content-Type: application/json' \
--data '
{
"action": "<string>",
"params": {
"email": "<string>"
}
}
'import requests
url = "https://api.linkupapi.com/v2/enrich"
payload = {
"action": "<string>",
"params": { "email": "<string>" }
}
headers = {"Content-Type": "application/json"}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'Content-Type': 'application/json'},
body: JSON.stringify({action: '<string>', params: {email: '<string>'}})
};
fetch('https://api.linkupapi.com/v2/enrich', 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/v2/enrich",
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([
'action' => '<string>',
'params' => [
'email' => '<string>'
]
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json"
],
]);
$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/v2/enrich"
payload := strings.NewReader("{\n \"action\": \"<string>\",\n \"params\": {\n \"email\": \"<string>\"\n }\n}")
req, _ := http.NewRequest("POST", url, payload)
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/v2/enrich")
.header("Content-Type", "application/json")
.body("{\n \"action\": \"<string>\",\n \"params\": {\n \"email\": \"<string>\"\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.linkupapi.com/v2/enrich")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n \"action\": \"<string>\",\n \"params\": {\n \"email\": \"<string>\"\n }\n}"
response = http.request(request)
puts response.read_body{
"success": true,
"data": {
"email_parsed": {
"original_email": "jane.doe@acme-corp.com",
"first_name": "Jane",
"last_name": "Doe",
"company_domain": "acme-corp.com",
"parsing_confidence": "high"
},
"person_found": {
"full_name": "Jane Doe",
"first_name": "Jane",
"last_name": "Doe",
"headline": "Senior Product Manager at Acme Corp",
"location": "San Francisco Bay Area",
"industry": "Computer Software",
"profile_url": "https://www.linkedin.com/in/jane-doe-42",
"experience": [
{
"company": "Acme Corp",
"title": "Senior Product Manager",
"start_date": "1/2023",
"end_date": ""
}
]
}
},
"metadata": {
"action": "reverse_email",
"credits_consumed": 1,
"timestamp": "2026-04-26T10:35:00Z"
}
}
{
"success": true,
"data": {
"email_parsed": {
"original_email": "j.doe@small-shop.io",
"first_name": "John",
"last_name": "Doe",
"company_domain": "small-shop.io",
"parsing_confidence": "medium"
},
"person_found": {
"full_name": "John Doe",
"first_name": "John",
"last_name": "Doe"
}
},
"metadata": {
"action": "reverse_email",
"credits_consumed": 1,
"timestamp": "2026-04-26T10:35:00Z"
}
}
{
"success": false,
"error": {
"code": "INVALID_PARAMS",
"message": "Only professional email addresses are accepted. Personal email providers (Gmail, Yahoo, Hotmail, etc.) are not supported."
},
"metadata": {
"action": "reverse_email",
"credits_consumed": 0,
"timestamp": "2026-04-26T10:35:00Z"
}
}
{
"success": false,
"error": {
"code": "INVALID_PARAMS",
"message": "Invalid email format"
},
"metadata": {
"action": "reverse_email",
"credits_consumed": 0,
"timestamp": "2026-04-26T10:35:00Z"
}
}
Overview
Reverse-resolves a professional email address into the matching profile, returning the person’s full identity (name, headline, current company, profile URL, etc.).Only professional email addresses are accepted. Personal providers (Gmail, Yahoo, Hotmail, Outlook, iCloud, ProtonMail, free.fr, orange.fr, etc.) are rejected with
INVALID_PARAMS.This endpoint consumes 1 credit per request.Request
string
required
Must be
"reverse_email".Response
boolean
Indicates whether the request was successful.
object
Show data properties
Show data properties
object
Output of the GPT parsing step.
Show email_parsed properties
Show email_parsed properties
object
The resolved person.
- When a profile is matched: full profile object (same shape as Get Profile Info) —
full_name,first_name,last_name,headline,location,summary,industry,experience,education,skills,profile_picture_url,connection_count, etc. - When no profile match is found: minimal fallback
{full_name, first_name, last_name}.
object
{
"success": true,
"data": {
"email_parsed": {
"original_email": "jane.doe@acme-corp.com",
"first_name": "Jane",
"last_name": "Doe",
"company_domain": "acme-corp.com",
"parsing_confidence": "high"
},
"person_found": {
"full_name": "Jane Doe",
"first_name": "Jane",
"last_name": "Doe",
"headline": "Senior Product Manager at Acme Corp",
"location": "San Francisco Bay Area",
"industry": "Computer Software",
"profile_url": "https://www.linkedin.com/in/jane-doe-42",
"experience": [
{
"company": "Acme Corp",
"title": "Senior Product Manager",
"start_date": "1/2023",
"end_date": ""
}
]
}
},
"metadata": {
"action": "reverse_email",
"credits_consumed": 1,
"timestamp": "2026-04-26T10:35:00Z"
}
}
{
"success": true,
"data": {
"email_parsed": {
"original_email": "j.doe@small-shop.io",
"first_name": "John",
"last_name": "Doe",
"company_domain": "small-shop.io",
"parsing_confidence": "medium"
},
"person_found": {
"full_name": "John Doe",
"first_name": "John",
"last_name": "Doe"
}
},
"metadata": {
"action": "reverse_email",
"credits_consumed": 1,
"timestamp": "2026-04-26T10:35:00Z"
}
}
{
"success": false,
"error": {
"code": "INVALID_PARAMS",
"message": "Only professional email addresses are accepted. Personal email providers (Gmail, Yahoo, Hotmail, etc.) are not supported."
},
"metadata": {
"action": "reverse_email",
"credits_consumed": 0,
"timestamp": "2026-04-26T10:35:00Z"
}
}
{
"success": false,
"error": {
"code": "INVALID_PARAMS",
"message": "Invalid email format"
},
"metadata": {
"action": "reverse_email",
"credits_consumed": 0,
"timestamp": "2026-04-26T10:35:00Z"
}
}
Was this page helpful?