Enrich Data
curl --request POST \
--url https://api.lemlist.com/api/enrich \
--header 'Authorization: Basic <encoded-value>'import requests
url = "https://api.lemlist.com/api/enrich"
headers = {"Authorization": "Basic <encoded-value>"}
response = requests.post(url, headers=headers)
print(response.text)const options = {method: 'POST', headers: {Authorization: 'Basic <encoded-value>'}};
fetch('https://api.lemlist.com/api/enrich', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));require 'uri'
require 'net/http'
url = URI("https://api.lemlist.com/api/enrich")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Basic <encoded-value>'
response = http.request(request)
puts response.read_body<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.lemlist.com/api/enrich",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_HTTPHEADER => [
"Authorization: Basic <encoded-value>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}{
"id": "enr_ExampleA1b2C3d4E5"
}
Popular Resources
Enrich Data
Enriches data by finding emails, phone numbers, or LinkedIn information from various inputs.
POST
/
enrich
Enrich Data
curl --request POST \
--url https://api.lemlist.com/api/enrich \
--header 'Authorization: Basic <encoded-value>'import requests
url = "https://api.lemlist.com/api/enrich"
headers = {"Authorization": "Basic <encoded-value>"}
response = requests.post(url, headers=headers)
print(response.text)const options = {method: 'POST', headers: {Authorization: 'Basic <encoded-value>'}};
fetch('https://api.lemlist.com/api/enrich', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));require 'uri'
require 'net/http'
url = URI("https://api.lemlist.com/api/enrich")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Basic <encoded-value>'
response = http.request(request)
puts response.read_body<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.lemlist.com/api/enrich",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_HTTPHEADER => [
"Authorization: Basic <encoded-value>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}{
"id": "enr_ExampleA1b2C3d4E5"
}
The API provides the ability to request data (email, phone number, LinkedIn information) in multiple ways:
When the enrichment cannot be started, the answer carries a
- Given some input (email, LinkedIn URL, etc.) for a single enrichment, with this endpoint
- For a lead already in lemlist, with Enrich Lead
- Many at once, with Bulk Enrich Data
id and the work runs in the background. There are two ways to retrieve your enriched data:
- Webhooks (recommended): receive an
enrichmentDoneorenrichmentErrorevent as soon as the enrichment is over, on your team’s webhooks and on thewebhookUrlpassed here. See Enrichment webhooks. - Polling: call Get Enrichment Result with the
id.
Every call starts a new enrichment and uses credits, even when the same person was enriched before.
code and a message: see Request errors.
Result
Sample enrichmentDone webhook
Sample enrichmentDone webhook
{
"type": "enrichmentDone",
"data": [
{
"id": "enr_ExampleA1b2C3d4E5",
"data": {
"find_email": {
"email": "john@example.com",
"notFound": false,
"status": "deliverable"
},
"find_phone": {
"phone": "+15555550100",
"notFound": false
},
"linkedin_enrichment": {
"linkedinUrl": "https://www.linkedin.com/in/john-doe",
"firstName": "John",
"lastName": "Doe",
"tagline": "Marketing Manager at Acme Inc",
"occupation": "Marketing Manager",
"locationName": "Paris, Île-de-France, France",
"industry": "Software Development",
"companyName": "Acme Inc",
"companyDomain": "example.com",
"companyLinkedinUrl": "https://www.linkedin.com/company/example",
"companyWebsite": "https://example.com",
"companyIndustry": "Software Development",
"companySize": "51-200",
"positionGroups": [
{
"company": {
"name": "Acme Inc",
"linkedinUrl": "https://www.linkedin.com/company/example/",
"domain": "example.com",
"website": "https://example.com",
"industry": "Software Development",
"size": "51-200"
},
"date": {
"start": { "month": 3, "year": 2024 },
"end": {}
},
"profilePositions": [
{
"title": "Marketing Manager",
"companyName": "Acme Inc",
"date": {
"start": { "month": 3, "year": 2024 },
"end": {}
}
}
]
}
]
}
},
"metadata": {}
}
]
}
Authorizations
Query Parameters
Was this page helpful?