Search Companies

Look up companies by identifier. Returns a preview of each company profile.

Accepted identifiers (at least one required per company):

Lusha company id
name
domain

Up to 100 companies per request. Each result includes a has field listing the data available via Enrich Companies.

Pass a signals filter to narrow results to companies showing specific activity (e.g. headcount growth, hiring surge).

Billing: Charged per successful result via the api_search action.

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",
        "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
        }
      ]
    }
  ],
  "billing": {
    "creditsCharged": 1,
    "resultsReturned": 3
  }
}

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",
        "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
        }
      ]
    }
  ],
  "billing": {
    "creditsCharged": 1,
    "resultsReturned": 3
  }
}

Overview

Resources

Endpoints

Search Companies

Authorizations

Body

Response