Search & Enrich
Search and Enrich Companies
Find companies and reveal their full data in a single call. Combines Search and Enrich into one request.
Provide company identifiers the same way you would for Search Companies. Up to 100 companies per request.
Use the reveal field to control which premium data points are unlocked, exactly as you would on Enrich Companies. Premium fields - including directParent and ultimateParent - are returned only when you name them in reveal; they are never included by default.
Billing: Same as Enrich Companies - charged per successful result via the
reveal_companyaction, plus one charge per revealed field.
POST
/
v3
/
companies
/
search-and-enrich
Search and Enrich Companies
curl --request POST \
--url https://api.lusha.com/v3/companies/search-and-enrich \
--header 'Content-Type: application/json' \
--header 'api_key: <api-key>' \
--data '
{
"companies": [
{
"clientReferenceId": "comp-ref-1",
"name": "Lusha"
},
{
"clientReferenceId": "comp-ref-2",
"domain": "salesforce.com"
},
{
"clientReferenceId": "comp-ref-3",
"domain": "4d.com"
}
],
"reveal": [
"directParent",
"ultimateParent"
],
"options": {
"includePartialProfiles": true
}
}
'import requests
url = "https://api.lusha.com/v3/companies/search-and-enrich"
payload = {
"companies": [
{
"clientReferenceId": "comp-ref-1",
"name": "Lusha"
},
{
"clientReferenceId": "comp-ref-2",
"domain": "salesforce.com"
},
{
"clientReferenceId": "comp-ref-3",
"domain": "4d.com"
}
],
"reveal": ["directParent", "ultimateParent"],
"options": { "includePartialProfiles": True }
}
headers = {
"api_key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {api_key: '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
companies: [
{clientReferenceId: 'comp-ref-1', name: 'Lusha'},
{clientReferenceId: 'comp-ref-2', domain: 'salesforce.com'},
{clientReferenceId: 'comp-ref-3', domain: '4d.com'}
],
reveal: ['directParent', 'ultimateParent'],
options: {includePartialProfiles: true}
})
};
fetch('https://api.lusha.com/v3/companies/search-and-enrich', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));HttpResponse<String> response = Unirest.post("https://api.lusha.com/v3/companies/search-and-enrich")
.header("api_key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"companies\": [\n {\n \"clientReferenceId\": \"comp-ref-1\",\n \"name\": \"Lusha\"\n },\n {\n \"clientReferenceId\": \"comp-ref-2\",\n \"domain\": \"salesforce.com\"\n },\n {\n \"clientReferenceId\": \"comp-ref-3\",\n \"domain\": \"4d.com\"\n }\n ],\n \"reveal\": [\n \"directParent\",\n \"ultimateParent\"\n ],\n \"options\": {\n \"includePartialProfiles\": true\n }\n}")
.asString();package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.lusha.com/v3/companies/search-and-enrich"
payload := strings.NewReader("{\n \"companies\": [\n {\n \"clientReferenceId\": \"comp-ref-1\",\n \"name\": \"Lusha\"\n },\n {\n \"clientReferenceId\": \"comp-ref-2\",\n \"domain\": \"salesforce.com\"\n },\n {\n \"clientReferenceId\": \"comp-ref-3\",\n \"domain\": \"4d.com\"\n }\n ],\n \"reveal\": [\n \"directParent\",\n \"ultimateParent\"\n ],\n \"options\": {\n \"includePartialProfiles\": true\n }\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("api_key", "<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))
}{
"requestId": "21fe0733-65d6-436a-8d0c-2c9ac6f263f8",
"results": [
{
"clientReferenceId": "comp-ref-1",
"id": "16303253",
"name": "Lusha",
"alternativeName": "lusha",
"domain": "www.lusha.com",
"alternativeDomains": [
"lusha.com"
],
"description": "Lusha is the leader in Sales Streaming – a new sales paradigm that streams top leads straight to salespeople and handles all the outreach, so they can escape the lead grind and just sell.",
"companyType": "Private Company",
"yearFounded": 2016,
"employeeCount": {
"exact": 364,
"min": 201,
"max": 500
},
"industry": "Technology, Information & Media",
"subIndustry": "Software Development",
"specialities": [
"data accuracy",
"data enrichment",
"lead discovery",
"lead generation",
"prospecting",
"sales enablement",
"sales intelligence",
"software development"
],
"sicCodes": [
{
"code": 7371,
"description": "Custom computer programming services"
}
],
"naicsCodes": [
{
"code": 541511,
"description": "Custom Computer Programming Services"
}
],
"location": {
"city": "Boston",
"state": "Massachusetts",
"country": "United States",
"countryIso2": "US",
"continent": "North America",
"zipCode": "02199"
},
"additionalLocations": [
{
"city": "New York City",
"state": "New York",
"country": "United States",
"countryIso2": "US",
"continent": "North America"
}
],
"socialLinks": {
"linkedin": "https://www.linkedin.com/company/lushadata"
},
"linkedinFollowers": 64339,
"funding": {
"rounds": [
{
"currency": "USD",
"roundAmount": 205000000,
"roundType": "Private Equity Round",
"roundDate": "Nov 10, 2021"
},
{
"currency": "USD",
"roundAmount": 40000000,
"roundType": "Private Equity Round",
"roundDate": "Feb 10, 2021"
}
],
"totalRounds": 2,
"totalRoundsAmount": 245000000,
"currency": "USD",
"isIpo": false,
"lastRoundType": "Private Equity Round",
"lastRoundAmount": 205000000,
"lastRoundDate": "Nov 10, 2021"
},
"technologies": [
"amazon",
"google analytics"
],
"popularityTier": 1,
"logoUrl": "https://logo.lusha.co/brightdata/year=2024/month=05/day=03/j_lvq47h0g13te1b3wpu.e7b0795e7affc9953dadd43e6fce99a2c5260043.file_lvq4cfwv17kcb9m4ej.logo_cached.jpg",
"businessModel": [
"B2B"
],
"emails": [
{
"email": "Support@Lusha.com"
}
],
"keywords": [
"contact information",
"data accuracy",
"data enrichment",
"lead discovery",
"lead generation",
"prospecting",
"sales enablement",
"sales intelligence",
"software development"
]
},
{
"clientReferenceId": "comp-ref-2",
"id": "12790225",
"name": "Salesforce",
"alternativeName": "salesforce",
"domain": "www.salesforce.com",
"alternativeDomains": [
"salesforce.com"
],
"description": "We're the #1 AI CRM-where humans with agents drive customer success together with AI, data, and Customer 360 apps on one platform.",
"companyType": "Public Company",
"employeeCount": {
"exact": 88711,
"min": 100001,
"max": 10000000
},
"industry": "Technology, Information & Media",
"subIndustry": "Software Development",
"sicCodes": [
{
"code": 7371,
"description": "Custom computer programming services"
}
],
"naicsCodes": [
{
"code": 541511,
"description": "Custom Computer Programming Services"
}
],
"location": {
"city": "San Francisco",
"state": "California",
"country": "United States",
"countryIso2": "US",
"continent": "North America",
"zipCode": "94105"
},
"additionalLocations": [
{
"country": "United States",
"countryIso2": "US",
"continent": "North America"
},
{
"city": "Chicago",
"state": "Illinois",
"country": "United States",
"countryIso2": "US",
"continent": "North America"
},
{
"city": "London",
"country": "United Kingdom",
"countryIso2": "GB",
"continent": "Europe"
},
{
"city": "Tel Aviv",
"country": "Israel",
"countryIso2": "IL",
"continent": "Asia"
}
],
"socialLinks": {
"linkedin": "https://www.linkedin.com/company/salesforce"
},
"linkedinFollowers": 6417067,
"revenueRange": {
"min": 10000000000,
"max": 100000000000
},
"intent": {
"detectedTopics": [
{
"topicName": "Cognism Limited",
"metadata": {
"topicScore": 85,
"topicTrend": "+24"
}
}
],
"topicCount": 1
},
"technologies": [
"amazon",
"paypal",
"google analytics"
],
"popularityTier": 1,
"logoUrl": "https://logo.lusha.co/brightdata/year=2024/month=05/day=20/j_lwej8xik12ncr6ge4u.9e1ec373903019beff129694cb926761f065e9af.file_lwejc8mispkz3m1ng.logo_cached.jpg",
"phones": [
{
"number": "+1 800-420-7332"
}
],
"emails": [
{
"email": "datasubjectrequest@salesforce.com"
}
],
"directParent": null,
"ultimateParent": null
},
{
"clientReferenceId": "comp-ref-3",
"id": "18654301",
"name": "4D",
"domain": "4d.com",
"companyType": "Subsidiary",
"directParent": {
"lushaCompanyId": "v1.XyZw...",
"name": "Volaris Group",
"domain": "volarisgroup.com"
},
"ultimateParent": {
"lushaCompanyId": "v1.QrSt...",
"name": "Constellation Software Inc.",
"domain": "csisoftware.com",
"hqCountry": "Canada"
}
}
],
"billing": {
"creditsCharged": 5,
"resultsReturned": 3
}
}Authorizations
Your Lusha API key. You can find this in your Lusha dashboard under API settings.
Include this key in the api_key header for all requests.
Body
application/json
Required array length:
1 - 100 elementsShow child attributes
Show child attributes
Additional data fields to reveal, using the same tokens as Enrich Companies.
Each field is charged separately per result. Premium fields are returned only
when named here - omitting reveal returns base firmographics alone.
See Enrich Companies for what each token unlocks.
Available options:
employeesByDepartment, employeesByLocation, employeesBySeniority, competitors, intent, estimatedAnnualItSpend, monthlyWebsiteTraffic, openJobsTotal, openJobsByDepartment, openJobsByLocation, openJobsBySeniority, directParent, ultimateParent Example:
["directParent", "ultimateParent"]
Additional options for search requests
Show child attributes
Show child attributes
Was this page helpful?
⌘I
Search and Enrich Companies
curl --request POST \
--url https://api.lusha.com/v3/companies/search-and-enrich \
--header 'Content-Type: application/json' \
--header 'api_key: <api-key>' \
--data '
{
"companies": [
{
"clientReferenceId": "comp-ref-1",
"name": "Lusha"
},
{
"clientReferenceId": "comp-ref-2",
"domain": "salesforce.com"
},
{
"clientReferenceId": "comp-ref-3",
"domain": "4d.com"
}
],
"reveal": [
"directParent",
"ultimateParent"
],
"options": {
"includePartialProfiles": true
}
}
'import requests
url = "https://api.lusha.com/v3/companies/search-and-enrich"
payload = {
"companies": [
{
"clientReferenceId": "comp-ref-1",
"name": "Lusha"
},
{
"clientReferenceId": "comp-ref-2",
"domain": "salesforce.com"
},
{
"clientReferenceId": "comp-ref-3",
"domain": "4d.com"
}
],
"reveal": ["directParent", "ultimateParent"],
"options": { "includePartialProfiles": True }
}
headers = {
"api_key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {api_key: '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
companies: [
{clientReferenceId: 'comp-ref-1', name: 'Lusha'},
{clientReferenceId: 'comp-ref-2', domain: 'salesforce.com'},
{clientReferenceId: 'comp-ref-3', domain: '4d.com'}
],
reveal: ['directParent', 'ultimateParent'],
options: {includePartialProfiles: true}
})
};
fetch('https://api.lusha.com/v3/companies/search-and-enrich', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));HttpResponse<String> response = Unirest.post("https://api.lusha.com/v3/companies/search-and-enrich")
.header("api_key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"companies\": [\n {\n \"clientReferenceId\": \"comp-ref-1\",\n \"name\": \"Lusha\"\n },\n {\n \"clientReferenceId\": \"comp-ref-2\",\n \"domain\": \"salesforce.com\"\n },\n {\n \"clientReferenceId\": \"comp-ref-3\",\n \"domain\": \"4d.com\"\n }\n ],\n \"reveal\": [\n \"directParent\",\n \"ultimateParent\"\n ],\n \"options\": {\n \"includePartialProfiles\": true\n }\n}")
.asString();package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.lusha.com/v3/companies/search-and-enrich"
payload := strings.NewReader("{\n \"companies\": [\n {\n \"clientReferenceId\": \"comp-ref-1\",\n \"name\": \"Lusha\"\n },\n {\n \"clientReferenceId\": \"comp-ref-2\",\n \"domain\": \"salesforce.com\"\n },\n {\n \"clientReferenceId\": \"comp-ref-3\",\n \"domain\": \"4d.com\"\n }\n ],\n \"reveal\": [\n \"directParent\",\n \"ultimateParent\"\n ],\n \"options\": {\n \"includePartialProfiles\": true\n }\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("api_key", "<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))
}{
"requestId": "21fe0733-65d6-436a-8d0c-2c9ac6f263f8",
"results": [
{
"clientReferenceId": "comp-ref-1",
"id": "16303253",
"name": "Lusha",
"alternativeName": "lusha",
"domain": "www.lusha.com",
"alternativeDomains": [
"lusha.com"
],
"description": "Lusha is the leader in Sales Streaming – a new sales paradigm that streams top leads straight to salespeople and handles all the outreach, so they can escape the lead grind and just sell.",
"companyType": "Private Company",
"yearFounded": 2016,
"employeeCount": {
"exact": 364,
"min": 201,
"max": 500
},
"industry": "Technology, Information & Media",
"subIndustry": "Software Development",
"specialities": [
"data accuracy",
"data enrichment",
"lead discovery",
"lead generation",
"prospecting",
"sales enablement",
"sales intelligence",
"software development"
],
"sicCodes": [
{
"code": 7371,
"description": "Custom computer programming services"
}
],
"naicsCodes": [
{
"code": 541511,
"description": "Custom Computer Programming Services"
}
],
"location": {
"city": "Boston",
"state": "Massachusetts",
"country": "United States",
"countryIso2": "US",
"continent": "North America",
"zipCode": "02199"
},
"additionalLocations": [
{
"city": "New York City",
"state": "New York",
"country": "United States",
"countryIso2": "US",
"continent": "North America"
}
],
"socialLinks": {
"linkedin": "https://www.linkedin.com/company/lushadata"
},
"linkedinFollowers": 64339,
"funding": {
"rounds": [
{
"currency": "USD",
"roundAmount": 205000000,
"roundType": "Private Equity Round",
"roundDate": "Nov 10, 2021"
},
{
"currency": "USD",
"roundAmount": 40000000,
"roundType": "Private Equity Round",
"roundDate": "Feb 10, 2021"
}
],
"totalRounds": 2,
"totalRoundsAmount": 245000000,
"currency": "USD",
"isIpo": false,
"lastRoundType": "Private Equity Round",
"lastRoundAmount": 205000000,
"lastRoundDate": "Nov 10, 2021"
},
"technologies": [
"amazon",
"google analytics"
],
"popularityTier": 1,
"logoUrl": "https://logo.lusha.co/brightdata/year=2024/month=05/day=03/j_lvq47h0g13te1b3wpu.e7b0795e7affc9953dadd43e6fce99a2c5260043.file_lvq4cfwv17kcb9m4ej.logo_cached.jpg",
"businessModel": [
"B2B"
],
"emails": [
{
"email": "Support@Lusha.com"
}
],
"keywords": [
"contact information",
"data accuracy",
"data enrichment",
"lead discovery",
"lead generation",
"prospecting",
"sales enablement",
"sales intelligence",
"software development"
]
},
{
"clientReferenceId": "comp-ref-2",
"id": "12790225",
"name": "Salesforce",
"alternativeName": "salesforce",
"domain": "www.salesforce.com",
"alternativeDomains": [
"salesforce.com"
],
"description": "We're the #1 AI CRM-where humans with agents drive customer success together with AI, data, and Customer 360 apps on one platform.",
"companyType": "Public Company",
"employeeCount": {
"exact": 88711,
"min": 100001,
"max": 10000000
},
"industry": "Technology, Information & Media",
"subIndustry": "Software Development",
"sicCodes": [
{
"code": 7371,
"description": "Custom computer programming services"
}
],
"naicsCodes": [
{
"code": 541511,
"description": "Custom Computer Programming Services"
}
],
"location": {
"city": "San Francisco",
"state": "California",
"country": "United States",
"countryIso2": "US",
"continent": "North America",
"zipCode": "94105"
},
"additionalLocations": [
{
"country": "United States",
"countryIso2": "US",
"continent": "North America"
},
{
"city": "Chicago",
"state": "Illinois",
"country": "United States",
"countryIso2": "US",
"continent": "North America"
},
{
"city": "London",
"country": "United Kingdom",
"countryIso2": "GB",
"continent": "Europe"
},
{
"city": "Tel Aviv",
"country": "Israel",
"countryIso2": "IL",
"continent": "Asia"
}
],
"socialLinks": {
"linkedin": "https://www.linkedin.com/company/salesforce"
},
"linkedinFollowers": 6417067,
"revenueRange": {
"min": 10000000000,
"max": 100000000000
},
"intent": {
"detectedTopics": [
{
"topicName": "Cognism Limited",
"metadata": {
"topicScore": 85,
"topicTrend": "+24"
}
}
],
"topicCount": 1
},
"technologies": [
"amazon",
"paypal",
"google analytics"
],
"popularityTier": 1,
"logoUrl": "https://logo.lusha.co/brightdata/year=2024/month=05/day=20/j_lwej8xik12ncr6ge4u.9e1ec373903019beff129694cb926761f065e9af.file_lwejc8mispkz3m1ng.logo_cached.jpg",
"phones": [
{
"number": "+1 800-420-7332"
}
],
"emails": [
{
"email": "datasubjectrequest@salesforce.com"
}
],
"directParent": null,
"ultimateParent": null
},
{
"clientReferenceId": "comp-ref-3",
"id": "18654301",
"name": "4D",
"domain": "4d.com",
"companyType": "Subsidiary",
"directParent": {
"lushaCompanyId": "v1.XyZw...",
"name": "Volaris Group",
"domain": "volarisgroup.com"
},
"ultimateParent": {
"lushaCompanyId": "v1.QrSt...",
"name": "Constellation Software Inc.",
"domain": "csisoftware.com",
"hqCountry": "Canada"
}
}
],
"billing": {
"creditsCharged": 5,
"resultsReturned": 3
}
}