Search and Enrich Companies

POST

companies

search-and-enrich

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
  }
}

Use this endpoint to find companies and reveal their full data in one request - it combines Search Companies and Enrich Companies into a single call. Provide identifiers the same way you would for Search Companies.

If you need to inspect what’s revealable and its credit cost before committing to a reveal, call Search Companies first, then Enrich Companies separately. Use this combined endpoint when you already know you want the full profile.

Endpoint

POST https://api.lusha.com/v3/companies/search-and-enrich

Authentication

string

required

Your Lusha API key.

Accepted identifiers

Each company in the companies array needs at least one of the following:

Lusha company id
name
domain

Request body

array

required

Up to 100 companies to find and enrich.

Show company fields

string

Your own reference ID for this company. Echoed back on the matching result.Example: comp-ref-1

string

A Lusha company ID.

string

The company name.

string

The company domain.

object

Show options fields

boolean

When true, includes companies with incomplete data in the results instead of dropping them.

Unlike Search and Enrich Contacts, this endpoint doesn’t take a reveal field - every matched company returns full firmographics automatically.

Response

string

Unique ID for this request, in UUID format.

object[]

One entry per company you searched for. Each result has the same shape as an Enrich Companies result, plus clientReferenceId.

Show result fields

string

Echoes the clientReferenceId you sent for this company.

string

number

object

exact, min, and max headcount.

string

object

HQ location.

object[]

All other known company sites.

LinkedIn URL.

object

min and max revenue estimates.

object

Funding history, when available.

string[]

object

Present instead of profile data when the lookup or enrich fails for this company.

Show properties

string

One of NOT_FOUND, COMPLIANCE_RESTRICTED, ENRICH_FAILED.

string

Human-readable description.

object

Show properties

integer

Credits charged for this request.

integer

Number of successful results.

Billing: Same as Enrich Companies - charged per successful result via the reveal_company action.

Error codes

Status	Meaning
`400`	Bad request - invalid input data
`401`	Unauthorized - invalid or missing API key
`402`	Payment required - insufficient credits
`403`	Forbidden - account inactive or V3 access not enabled
`429`	Too many requests - rate limit exceeded

Example

curl --request POST \
  --url https://api.lusha.com/v3/companies/search-and-enrich \
  --header 'api_key: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "companies": [
      { "clientReferenceId": "comp-ref-1", "name": "Lusha" },
      { "clientReferenceId": "comp-ref-2", "domain": "salesforce.com" }
    ],
    "options": {
      "includePartialProfiles": true
    }
  }'

{
  "companies": [
    { "clientReferenceId": "comp-ref-1", "name": "Lusha" },
    { "clientReferenceId": "comp-ref-2", "domain": "salesforce.com" }
  ],
  "options": {
    "includePartialProfiles": true
  }
}

Example response

{
  "requestId": "6e4b1192-9440-42c4-9a3e-793ddef6d73c",
  "results": [
    {
      "clientReferenceId": "comp-ref-1",
      "id": "16303253",
      "name": "Lusha",
      "domain": "www.lusha.com",
      "description": "Lusha is the leader in Sales Streaming.",
      "companyType": "Private Company",
      "yearFounded": 2016,
      "employeeCount": { "exact": 364, "min": 201, "max": 500 },
      "industry": "Technology, Information & Media",
      "subIndustry": "Software Development"
    }
  ],
  "billing": {
    "creditsCharged": 1,
    "resultsReturned": 1
  }
}

Authorizations

api_key

string

header

required

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

companies

object[]

required

Required array length: 1 - 100 elements

Show child attributes

reveal

enum<string>[]

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"]

options

object

Additional options for search requests

Show child attributes

Response

Successful response

requestId

string<uuid>

results

object[]

Show child attributes

billing

object

Credit usage summary for a V3 API request

Show child attributes

⌘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
  }
}

Overview

Resources

Endpoints

Endpoint

Authentication

Accepted identifiers

Request body

Response

Error codes

Example

Authorizations

Body

Response

​Endpoint

​Authentication

​Accepted identifiers

​Request body

​Response

​Error codes

​Example

Authorizations

Body

Response

Endpoint

Authentication

Accepted identifiers

Request body

Response

Error codes

Example