Search prospecting companies by firmographic filters

POST https://api.lusha.com/v3/companies/prospecting takes firmographic filters describing your target account profile and returns a paginated list of matching company previews, each with an id. It does not return full firmographic records. To get those, pass the id values you want to Enrich Companies. Before building your request, use the company filter types and company filter values endpoints to look up valid values for each field.

Request body

Send a JSON body with pagination and filters.companies.include (required). All filter fields are optional - include only the ones relevant to your target accounts.

{
  "pagination": { "page": 0, "size": 25 },
  "filters": {
    "companies": {
      "include": {
        "mainIndustriesIds": [4, 5],
        "sizes": [{ "min": 51, "max": 500 }],
        "revenues": [{ "min": 10000000, "max": 50000000 }],
        "locations": [{ "country": "United States", "state": "New York" }],
        "technologies": ["Salesforce", "HubSpot"],
        "technologiesCondition": "or"
      }
    }
  }
}

Common filter fields

Field	Type	Description
`filters.companies.include.mainIndustriesIds` / `subIndustriesIds`	integer[]	Industry IDs
`filters.companies.include.sizes`	object[]	Employee count ranges as `{ "min": ..., "max": ... }`
`filters.companies.include.revenues`	object[]	Revenue ranges as `{ "min": ..., "max": ... }`
`filters.companies.include.locations`	object[]	Geographic filters
`filters.companies.include.sicCodes`	string[]	SIC industry classification codes
`filters.companies.include.naicsCodes`	string[]	NAICS industry classification codes
`filters.companies.include.technologies`	string[]	Technologies the company uses, combined via `technologiesCondition` (`or`/`and`)
`filters.companies.include.intentTopics`	string[]	Buyer intent topics, combined via `intentTopicsCondition` (`or`/`and`)
`filters.companies.exclude.domains`	string[]	Domains to remove from results
`pagination.page` / `pagination.size`	integer	Pagination - `page` ranges `0–1000`, `size` ranges `10–100`

See the full field reference for every available filter, including founded year, funding, business model, and company type.

Signal filtering

Narrow results to companies that have recently undergone a specific business event.

Credits are charged for each matched signal type per result, on top of the standard per-result charge.

Add a signals object under filters.companies.include:

{
  "filters": {
    "companies": {
      "include": {
        "mainIndustriesIds": [4, 5],
        "sizes": [{ "min": 500, "max": 5000 }],
        "signals": {
          "types": ["headcountIncrease3m", "surgeInHiring"],
          "startDate": "2025-01-01"
        }
      }
    }
  },
  "pagination": { "page": 0, "size": 25 }
}

Company signal filters also accept filterByLocation and filterByDepartment to scope matching to a specific geography or department. See Signals for background on available signal types.

Example request

curl --request POST \
  --url https://api.lusha.com/v3/companies/prospecting \
  --header 'api_key: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "pagination": { "page": 0, "size": 25 },
    "filters": {
      "companies": {
        "include": {
          "sizes": [{ "min": 1, "max": 1000 }],
          "locations": [{ "country": "United States" }],
          "technologies": ["React", "Node.js"],
          "mainIndustriesIds": [1, 5]
        }
      }
    }
  }'

{
  "pagination": { "page": 0, "size": 25 },
  "filters": {
    "companies": {
      "include": {
        "sizes": [{ "min": 1, "max": 1000 }],
        "locations": [{ "country": "United States" }],
        "technologies": ["React", "Node.js"],
        "mainIndustriesIds": [1, 5]
      }
    }
  }
}

Example response

{
  "requestId": "5ad275c8-7dd4-462a-bd45-6bc1970da64e",
  "pagination": { "page": 0, "size": 25, "total": 874 },
  "results": [
    {
      "id": "16303253",
      "name": "Lusha",
      "domain": "www.lusha.com",
      "employeeCount": { "min": 201, "max": 500 },
      "industry": "Technology, Information & Media"
    }
  ],
  "billing": {
    "creditsCharged": 1,
    "resultsReturned": 1
  }
}

Each result’s id is what you pass to Enrich Companies to reveal full firmographic records. Previews may also include has (fields already populated) and canReveal (fields you can reveal, and at what credit cost) - see the full API reference for the complete response schema.

Use the company filter types and company filter values endpoints to fetch valid values for mainIndustriesIds, sizes, revenues, sicCodes, naicsCodes, intentTopics, and technologies before building your search request.

Overview

Resources

Endpoints

Search prospecting companies by firmographic filters

Request body

Common filter fields

Signal filtering

Example request

Example response

​Request body

​Common filter fields

​Signal filtering

​Example request

​Example response

Request body

Common filter fields

Signal filtering

Example request

Example response