Search prospecting companies by firmographic filters

POST https://api.lusha.com/prospecting/company/search is step 2 of the 3-step company prospecting flow. You pass firmographic filters that describe your target account profile and receive back a paginated list of matching companies, each with an id. No credits are consumed at this step - credits are charged when you enrich the results in step 3. Before building your request, use the Company Filters endpoints to look up valid values for each field.

Request body

Send a JSON body with a filters.companies object. All filter fields are optional - include only the ones relevant to your target accounts.

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

Common filter fields

Field	Type	Description
`filters.companies.include.names`	string[]	Company names to include - use POST /prospecting/filters/companies/names
`filters.companies.include.mainIndustriesIds` / `subIndustriesIds`	number[]	Industry IDs - use GET /prospecting/filters/companies/industries_labels
`filters.companies.include.sizes`	object[]	Employee count ranges as `{ "min": ..., "max": ... }` - use GET /prospecting/filters/companies/sizes
`filters.companies.include.revenues`	object[]	Revenue ranges as `{ "min": ..., "max": ... }` - use GET /prospecting/filters/companies/revenues
`filters.companies.include.locations`	object[]	HQ location filters - use POST /prospecting/filters/companies/locations
`filters.companies.include.companyLocations`	object[]	Office location filters based on all known company locations, not just HQ
`filters.companies.include.sicCodes`	string[]	SIC industry classification codes - use GET /prospecting/filters/companies/sics
`filters.companies.include.naicsCodes`	string[]	NAICS industry classification codes - use GET /prospecting/filters/companies/naics
`filters.companies.include.technologies`	object[]	Technologies the company uses, each as `{ "name": "..." }` - use POST /prospecting/filters/companies/technologies
`filters.companies.include.intentTopics`	string[]	Buyer intent topics - use GET /prospecting/filters/companies/intent_topics
`pages.page` / `pages.size`	number	Pagination - `page` ranges `0–1000`, `size` ranges `10–50`

Signal filtering (premium feature)

You can narrow results to companies that have recently undergone a specific business event by filtering on signal types.

Signal filtering is a premium feature. Credits are charged for each signal type that returns results.

Add a signal object under filters.companies.include to match companies with recent activity:

{
  "filters": {
    "companies": {
      "include": {
        "mainIndustriesIds": [4, 5],
        "sizes": [{ "min": 500, "max": 5000 }],
        "signal": {
          "names": ["surgeInHiring", "financialEventsNews"],
          "startDate": "2025-01-01"
        }
      }
    }
  },
  "pages": { "page": 0, "size": 25 }
}

Company signal names use the same values as the Signals API - for example surgeInHiring, headcountIncrease6m, websiteTrafficIncrease, and financialEventsNews. See GET /api/signals/filters/company for the complete list.

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": 201, "max": 1000 }],
          "locations": [{ "country": "United States" }],
          "technologies": [{ "name": "Salesforce" }]
        }
      }
    },
    "pages": { "page": 0, "size": 25 }
  }'

{
  "filters": {
    "companies": {
      "include": {
        "mainIndustriesIds": [4, 5],
        "sizes": [{ "min": 201, "max": 1000 }],
        "locations": [{ "country": "United States" }],
        "technologies": [{ "name": "Salesforce" }]
      }
    }
  },
  "pages": { "page": 0, "size": 25 }
}

Example response

{
  "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,
      "hasCompanyTechnologies": true
    }
  ]
}

The requestId and each company’s id are what you pass to the Enrich Companies endpoint to retrieve full records. See the full API reference for the complete response schema, including all has* availability flags.

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

Overview

Credits & Plans

Guides

Endpoints

Search prospecting companies by firmographic filters

Request body

Common filter fields

Signal filtering (premium feature)

Example request

Example response

​Request body

​Common filter fields

​Signal filtering (premium feature)

​Example request

​Example response

Request body

Common filter fields

Signal filtering (premium feature)

Example request

Example response