POST /prospecting/company/search - Search companies

POST

prospecting

company

curl --request POST \
  --url https://api.lusha.com/prospecting/company/search \
  --header 'Content-Type: application/json' \
  --header 'api_key: <api-key>' \
  --data '
{
  "pages": {
    "page": 0,
    "size": 20
  },
  "filters": {
    "companies": {
      "include": {
        "companyLocations": [
          {
            "country": "United States",
            "state": "California"
          },
          {
            "country": "Germany"
          }
        ]
      }
    }
  }
}
'

{
  "requestId": "5ad275c8-7dd4-462a-bd45-6bc1970da64e",
  "currentPage": 0,
  "pageLength": 2,
  "totalResults": 874,
  "companies": [
    {
      "id": "33222678",
      "name": "Lusha",
      "fqdn": "lusha.com",
      "description": "Lusha is the sales intelligence platform designed to help businesses get their next customers.",
      "logoUrl": "https://logo.lusha.co/logo.jpg",
      "hasCompanyEmployeesCount": true,
      "hasCompanyRevenue": true,
      "hasCompanyMainIndustry": true,
      "hasCompanyFunding": true,
      "hasCompanyTechnologies": true,
      "signalTypes": ["surgeInHiring"]
    }
  ]
}

{
  "statusCode": 400,
  "message": "Validation failed",
  "errors": ["filters is required"]
}

Use this endpoint to find companies in Lusha’s database that match your target account criteria. Supply firmographic filters such as industry, employee size, revenue range, technologies in use, and more to build a focused account list. The response includes company IDs you then pass to the Enrich Companies endpoint to retrieve full firmographic profiles. This is step 2 of the three-step prospecting flow.

Prospecting flow

Step	Endpoint	Purpose
1	Filters API	Discover valid filter values for your search
2	POST /prospecting/company/search	Query companies using your filters
3	POST /prospecting/company/enrich	Retrieve full company profiles by ID

Endpoint

POST https://api.lusha.com/prospecting/company/search

Authentication: API key (ApiKeyAuth)

Request body

object

required

The top-level filter container.

Show filters.companies

object

Criteria that matching companies must satisfy. The same fields are available under filters.companies.exclude to remove companies from results.

Show include fields

string[]

Company names to include. Example: ["Apple", "Google"]

string[]

Company domains to include. Example: ["lusha.com"]

number[]

Main industry IDs. Example: [4, 5]

number[]

Sub-industry IDs. Example: [101]

object[]

Employee count ranges. Each object has min and max number fields. Example: [{ "min": 1, "max": 10 }]

object[]

Revenue ranges. Each object has min and max values.

object[]

HQ location filters. Each object may include country and other geographic fields. Example: [{ "country": "United States" }]

This filter matches against HQ location only. To find companies with offices in a specific region regardless of HQ, use companyLocations instead.

object[]

Office location filters based on all known company locations (not just HQ), as reported by LinkedIn.Each object may include:

country (string) - required
state (string) - optional

Example: [{ "country": "United States", "state": "California" }, { "country": "Germany" }]

object

Filter by LinkedIn-reported employee count. Both min and max are optional.

Show fields

integer

Minimum employee count (inclusive). Example: 100

integer

Maximum employee count (inclusive). Example: 5000

object[]

Filter by technologies the company uses. Each object requires a name field. Example: [{ "name": "Salesforce" }]

string[]

Filter by buyer intent topics. Example: ["Digital Sales"]

string[]

SIC industry codes. Example: ["1011", "1021"]

string[]

NAICS industry codes. Example: ["11", "21"]

string

Free-text search across company fields. Example: "Finance Marketing in Germany"

object

Premium feature. Filter companies that have signals of the specified types. Credits are charged for each signal type that returns results.See GET /api/signals/filters/company for available signal type values.

Show signal fields

string[]

Signal types to match. Allowed values include: "allSignals", "surgeInHiring", "headcountIncrease6m", "websiteTrafficIncrease", "financialEventsNews", and all other company signal types.

string

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

boolean

When true, excludes companies with incomplete data from results.

object

Same structure as include. Companies matching these criteria are removed from results.

object

Pagination controls.

Show pages fields

number

default:"0"

Page number. Range: 0–1000.

number

default:"20"

Results per page. Range: 10–50.

Example request

curl --request POST \
  --url https://api.lusha.com/prospecting/company/search \
  --header 'api_key: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "filters": {
      "companies": {
        "include": {
          "mainIndustriesIds": [4, 5],
          "sizes": [{ "min": 100, "max": 5000 }],
          "locations": [{ "country": "United States" }],
          "technologies": [{ "name": "Salesforce" }],
          "intentTopics": ["Digital Sales"]
        }
      }
    },
    "pages": { "page": 0, "size": 25 }
  }'

{
  "filters": {
    "companies": {
      "include": {
        "mainIndustriesIds": [4, 5],
        "sizes": [{ "min": 100, "max": 5000 }],
        "locations": [{ "country": "United States" }],
        "technologies": [{ "name": "Salesforce" }],
        "intentTopics": ["Digital Sales"],
        "signal": {
          "names": ["surgeInHiring", "financialEventsNews"],
          "startDate": "2025-01-01"
        }
      }
    }
  },
  "pages": { "page": 0, "size": 25 }
}

Response

200 - Success

string

Unique ID for this search. Pass this to the Enrich Companies endpoint as requestId.

number

The page number returned.

number

Number of results on this page.

number

Total number of companies matching your filters across all pages.

object[]

Array of matching companies.

Show company fields

string

Lusha company identifier. Use this in the Enrich Companies request.

string

Company name.

string

Company domain. Example: "lusha.com"

string

Company description.

string

URL to the company logo image.

string[]

Signal types detected for this company. Only present when signal filtering was requested.

boolean

Whether headcount data is available.

boolean

Whether revenue data is available.

boolean

Whether main industry classification is available.

boolean

Whether sub-industry classification is available.

boolean

Whether funding data is available.

boolean

Whether buyer intent data is available.

boolean

Whether technology stack data is available.

boolean

Whether the company’s city is available.

boolean

Whether the company’s country is available.

Error codes

Status	Meaning
`400`	Validation failed - check your request body for missing or invalid fields.
`401`	Unauthorized - your API key is missing or invalid.
`429`	Too many requests - you have exceeded the rate limit.
`500`	Internal server error - retry with exponential backoff.

{
  "requestId": "5ad275c8-7dd4-462a-bd45-6bc1970da64e",
  "currentPage": 0,
  "pageLength": 2,
  "totalResults": 874,
  "companies": [
    {
      "id": "33222678",
      "name": "Lusha",
      "fqdn": "lusha.com",
      "description": "Lusha is the sales intelligence platform designed to help businesses get their next customers.",
      "logoUrl": "https://logo.lusha.co/logo.jpg",
      "hasCompanyEmployeesCount": true,
      "hasCompanyRevenue": true,
      "hasCompanyMainIndustry": true,
      "hasCompanyFunding": true,
      "hasCompanyTechnologies": true,
      "signalTypes": ["surgeInHiring"]
    }
  ]
}

{
  "statusCode": 400,
  "message": "Validation failed",
  "errors": ["filters is required"]
}

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

filters

object

required

Show child attributes

pages

object

Show child attributes

Response

Search results with company IDs

requestId

string

The requestId that should be used in Prospecting Enrich request API params

currentPage

number

Current page of search results

pageLength

number

Page length

totalResults

number

Total search results

companies

object[]

Show child attributes

⌘I

curl --request POST \
  --url https://api.lusha.com/prospecting/company/search \
  --header 'Content-Type: application/json' \
  --header 'api_key: <api-key>' \
  --data '
{
  "pages": {
    "page": 0,
    "size": 20
  },
  "filters": {
    "companies": {
      "include": {
        "companyLocations": [
          {
            "country": "United States",
            "state": "California"
          },
          {
            "country": "Germany"
          }
        ]
      }
    }
  }
}
'

{
  "requestId": "5ad275c8-7dd4-462a-bd45-6bc1970da64e",
  "currentPage": 0,
  "pageLength": 2,
  "totalResults": 874,
  "companies": [
    {
      "id": "33222678",
      "name": "Lusha",
      "fqdn": "lusha.com",
      "description": "Lusha is the sales intelligence platform designed to help businesses get their next customers.",
      "logoUrl": "https://logo.lusha.co/logo.jpg",
      "hasCompanyEmployeesCount": true,
      "hasCompanyRevenue": true,
      "hasCompanyMainIndustry": true,
      "hasCompanyFunding": true,
      "hasCompanyTechnologies": true,
      "signalTypes": ["surgeInHiring"]
    }
  ]
}

{
  "statusCode": 400,
  "message": "Validation failed",
  "errors": ["filters is required"]
}

​Endpoint

​Request body

​Example request

​Response

​200 - Success

​Error codes

Authorizations

Body

Response

Endpoint

Request body

Example request

Response

200 - Success

Error codes