Search Companies

POST

companies

Search Companies

curl --request POST \
  --url https://api.lusha.com/v3/companies/search \
  --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",
      "id": "16303253"
    }
  ],
  "options": {
    "includePartialProfiles": true
  }
}
'

import requests

url = "https://api.lusha.com/v3/companies/search"

payload = {
    "companies": [
        {
            "clientReferenceId": "comp-ref-1",
            "name": "Lusha"
        },
        {
            "clientReferenceId": "comp-ref-2",
            "domain": "salesforce.com"
        },
        {
            "clientReferenceId": "comp-ref-3",
            "id": "16303253"
        }
    ],
    "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', id: '16303253'}
    ],
    options: {includePartialProfiles: true}
  })
};

fetch('https://api.lusha.com/v3/companies/search', 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")
  .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      \"id\": \"16303253\"\n    }\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"

	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      \"id\": \"16303253\"\n    }\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": "abd4a213-d33b-4565-b9b6-55c19c65cc47",
  "results": [
    {
      "clientReferenceId": "comp-ref-1",
      "id": "16303253",
      "name": "Lusha",
      "domain": "www.lusha.com",
      "employeeCount": {
        "exact": 364,
        "min": 201,
        "max": 500
      },
      "industry": "Technology, Information & Media",
      "location": {
        "city": "Boston",
        "state": "Massachusetts",
        "country": "United States",
        "countryIso2": "US",
        "continent": "North America"
      },
      "socialLinks": {
        "linkedin": "https://www.linkedin.com/company/lushadata"
      },
      "has": [
        "alternativeName",
        "alternativeDomains",
        "description",
        "companyType",
        "yearFounded",
        "subIndustry",
        "specialities",
        "sicCodes",
        "naicsCodes",
        "additionalLocations",
        "linkedinFollowers",
        "funding",
        "popularityTier",
        "logoUrl",
        "employeesByDepartment",
        "employeesByLocation",
        "employeesBySeniority",
        "competitors",
        "businessModel",
        "emails",
        "keywords",
        "socialLinks"
      ],
      "canReveal": [
        {
          "field": "employeesByDepartment",
          "credits": 1
        },
        {
          "field": "employeesByLocation",
          "credits": 1
        },
        {
          "field": "employeesBySeniority",
          "credits": 1
        },
        {
          "field": "competitors",
          "credits": 1
        }
      ]
    },
    {
      "clientReferenceId": "comp-ref-2",
      "id": "12790225",
      "name": "Salesforce",
      "domain": "www.salesforce.com",
      "employeeCount": {
        "exact": 88711,
        "min": 100001,
        "max": 10000000
      },
      "industry": "Technology, Information & Media",
      "location": {
        "city": "San Francisco",
        "state": "California",
        "country": "United States",
        "countryIso2": "US",
        "continent": "North America"
      },
      "socialLinks": {
        "linkedin": "https://www.linkedin.com/company/salesforce"
      },
      "has": [
        "alternativeName",
        "alternativeDomains",
        "description",
        "companyType",
        "subIndustry",
        "sicCodes",
        "naicsCodes",
        "additionalLocations",
        "linkedinFollowers",
        "revenueRange",
        "intent",
        "popularityTier",
        "logoUrl",
        "employeesByDepartment",
        "employeesByLocation",
        "employeesBySeniority",
        "competitors",
        "phones",
        "emails",
        "socialLinks"
      ],
      "canReveal": [
        {
          "field": "employeesByDepartment",
          "credits": 1
        },
        {
          "field": "employeesByLocation",
          "credits": 1
        },
        {
          "field": "employeesBySeniority",
          "credits": 1
        },
        {
          "field": "competitors",
          "credits": 1
        },
        {
          "field": "intent",
          "credits": 0
        }
      ]
    }
  ],
  "billing": {
    "creditsCharged": 1,
    "resultsReturned": 3
  }
}

Use this endpoint to look up companies by identifier and get back a preview of each matching profile. Each result’s has field lists the data available via Enrich Companies.

Endpoint

POST https://api.lusha.com/v3/companies/search

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

Attach a clientReferenceId to each company so you can match results back to your input - the array of results isn’t guaranteed to preserve input order.

Request body

array

required

Up to 100 companies to look up.

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.Example: 16303253

string

The company name.Example: Lusha

string

The company domain.Example: salesforce.com

object

Show options fields

boolean

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

object

Narrow results to companies with recent activity, such as headcount growth or hiring surges.

Show signals fields

string[]

required

Signal types to match.Allowed values: allSignals, websiteTrafficIncrease, websiteTrafficDecrease, itSpendIncrease, itSpendDecrease, surgeInHiring, headcountIncrease1m, headcountIncrease3m, headcountIncrease6m, headcountIncrease12m, headcountDecrease1m, headcountDecrease3m, headcountDecrease6m, headcountDecrease12m, surgeInHiringByDepartment, surgeInHiringByLocation, riskNews, commercialActivityNews, corporateStrategyNews, financialEventsNews, peopleNews, marketIntelligenceNews, productActivityNews

string

Earliest signal date, in YYYY-MM-DD format.Example: 2025-01-01

integer

Maximum results to return per signal type. Range: 1–100.Example: 10

Response

string

Unique ID for this request, in UUID format.

object[]

One entry per company you searched for.

Show result fields

string

Echoes the clientReferenceId you sent for this company.

string

The Lusha company ID. Pass this to Enrich Companies to reveal firmographics and more.

string

Company name.

string

Company domain.

object

Show properties

integer

Exact known headcount. Example: 364

integer

Range minimum. Example: 201

integer

Range maximum. Example: 500

string

Industry. Example: Technology, Information & Media

object

Show properties

string

Example: London

string

Example: England

string

Example: United Kingdom

string

Example: GB

string

Example: Europe

Show properties

string

LinkedIn company URL.

string[]

Data available for this profile. Example: ["alternativeName", "description", "companyType", "employeesByDepartment", "competitors", "emails", "socialLinks"]

object[]

What you can unlock via Enrich Companies, and its credit cost.

Show properties

string

emails or phones.

integer

Credit cost. 0 if already revealed for your account.

string[]

Signal types detected for this company, when a signals filter was applied. Example: ["headcountIncrease3m"]

object

Present instead of profile data when the lookup 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: Charged per successful result via the api_search 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 \
  --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",
      "employeeCount": { "exact": 364, "min": 201, "max": 500 },
      "industry": "Technology, Information & Media",
      "location": {
        "city": "Tel Aviv",
        "country": "Israel",
        "countryIso2": "IL",
        "continent": "Asia"
      },
      "socialLinks": {
        "linkedin": "https://www.linkedin.com/company/lushadata"
      },
      "has": ["alternativeName", "description", "companyType", "employeesByDepartment", "competitors", "emails", "socialLinks"],
      "canReveal": [
        { "field": "emails", "credits": 1 }
      ]
    }
  ],
  "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

options

object

Additional options for search requests

Show child attributes

signals

object

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 Companies

curl --request POST \
  --url https://api.lusha.com/v3/companies/search \
  --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",
      "id": "16303253"
    }
  ],
  "options": {
    "includePartialProfiles": true
  }
}
'

import requests

url = "https://api.lusha.com/v3/companies/search"

payload = {
    "companies": [
        {
            "clientReferenceId": "comp-ref-1",
            "name": "Lusha"
        },
        {
            "clientReferenceId": "comp-ref-2",
            "domain": "salesforce.com"
        },
        {
            "clientReferenceId": "comp-ref-3",
            "id": "16303253"
        }
    ],
    "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', id: '16303253'}
    ],
    options: {includePartialProfiles: true}
  })
};

fetch('https://api.lusha.com/v3/companies/search', 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")
  .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      \"id\": \"16303253\"\n    }\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"

	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      \"id\": \"16303253\"\n    }\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": "abd4a213-d33b-4565-b9b6-55c19c65cc47",
  "results": [
    {
      "clientReferenceId": "comp-ref-1",
      "id": "16303253",
      "name": "Lusha",
      "domain": "www.lusha.com",
      "employeeCount": {
        "exact": 364,
        "min": 201,
        "max": 500
      },
      "industry": "Technology, Information & Media",
      "location": {
        "city": "Boston",
        "state": "Massachusetts",
        "country": "United States",
        "countryIso2": "US",
        "continent": "North America"
      },
      "socialLinks": {
        "linkedin": "https://www.linkedin.com/company/lushadata"
      },
      "has": [
        "alternativeName",
        "alternativeDomains",
        "description",
        "companyType",
        "yearFounded",
        "subIndustry",
        "specialities",
        "sicCodes",
        "naicsCodes",
        "additionalLocations",
        "linkedinFollowers",
        "funding",
        "popularityTier",
        "logoUrl",
        "employeesByDepartment",
        "employeesByLocation",
        "employeesBySeniority",
        "competitors",
        "businessModel",
        "emails",
        "keywords",
        "socialLinks"
      ],
      "canReveal": [
        {
          "field": "employeesByDepartment",
          "credits": 1
        },
        {
          "field": "employeesByLocation",
          "credits": 1
        },
        {
          "field": "employeesBySeniority",
          "credits": 1
        },
        {
          "field": "competitors",
          "credits": 1
        }
      ]
    },
    {
      "clientReferenceId": "comp-ref-2",
      "id": "12790225",
      "name": "Salesforce",
      "domain": "www.salesforce.com",
      "employeeCount": {
        "exact": 88711,
        "min": 100001,
        "max": 10000000
      },
      "industry": "Technology, Information & Media",
      "location": {
        "city": "San Francisco",
        "state": "California",
        "country": "United States",
        "countryIso2": "US",
        "continent": "North America"
      },
      "socialLinks": {
        "linkedin": "https://www.linkedin.com/company/salesforce"
      },
      "has": [
        "alternativeName",
        "alternativeDomains",
        "description",
        "companyType",
        "subIndustry",
        "sicCodes",
        "naicsCodes",
        "additionalLocations",
        "linkedinFollowers",
        "revenueRange",
        "intent",
        "popularityTier",
        "logoUrl",
        "employeesByDepartment",
        "employeesByLocation",
        "employeesBySeniority",
        "competitors",
        "phones",
        "emails",
        "socialLinks"
      ],
      "canReveal": [
        {
          "field": "employeesByDepartment",
          "credits": 1
        },
        {
          "field": "employeesByLocation",
          "credits": 1
        },
        {
          "field": "employeesBySeniority",
          "credits": 1
        },
        {
          "field": "competitors",
          "credits": 1
        },
        {
          "field": "intent",
          "credits": 0
        }
      ]
    }
  ],
  "billing": {
    "creditsCharged": 1,
    "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