# Search Companies

Search for companies using various filters. This is step 2 of the prospecting process.

Endpoint: (POST)  https://api.lusha.com/prospecting/company/search
---

##### Signal Filtering (Premium Feature)
Filter companies by signal types to identify those with recent business events and changes.

  > Note: This is a premium feature. Credits are charged for each signal type that returns results.

Endpoint: POST /prospecting/company/search
Security: ApiKeyAuth

## Request fields (application/json):

  - `pages` (object)

  - `pages.page` (number)
    Page number (0-1000)

  - `pages.size` (number)
    Page size (10-50)

  - `filters` (object, required)

  - `filters.companies` (object)

  - `filters.companies.include` (object)

  - `filters.companies.include.names` (array)
    Example: ["Apple"]

  - `filters.companies.include.domains` (array)
    Example: ["lusha.com"]

  - `filters.companies.include.locations` (array)

  - `filters.companies.include.locations.country` (string)
    Example: "United States"

  - `filters.companies.include.technologies` (array)
    Example: ["Amazon"]

  - `filters.companies.include.intentTopics` (array)
    Example: ["Digital Sales"]

  - `filters.companies.include.sizes` (array)

  - `filters.companies.include.sizes.min` (number)
    Example: 1

  - `filters.companies.include.sizes.max` (number)
    Example: 10

  - `filters.companies.include.revenues` (array)

  - `filters.companies.include.sicCodes` (array)
    Example: ["1011","1021"]

  - `filters.companies.include.naicsCodes` (array)
    Example: ["11","21"]

  - `filters.companies.include.mainIndustriesIds` (array)
    Example: [4,5]

  - `filters.companies.include.subIndustriesIds` (array)
    Example: [101]

  - `filters.companies.include.searchText` (string)
    Free-text search across company fields
    Example: "Finance Marketing in Germany DE"

  - `filters.companies.include.excludePartialCompanies` (boolean)

  - `filters.companies.include.signal` (object)
    Filter companies by signal types (premium filter - charges apply per signal type)

  - `filters.companies.include.signal.names` (array)
    Signal types to filter by
    Enum: "allSignals", "newsEvent"

  - `filters.companies.include.signal.startDate` (string)
    Start date for signal detection (YYYY-MM-DD format)
    Example: "2025-11-01"

  - `filters.companies.exclude` (object)
    Same structure as include, for exclusion filters

## Response 200 fields (application/json):

  - `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` (array)

  - `companies.id` (string)
    A unique identifier for a Lusha company

  - `companies.name` (string)
    The name of the company

  - `companies.fqdn` (string)
    The fqdn of the company

  - `companies.description` (string)
    A description of the company

  - `companies.logoUrl` (string)
    The URL of the company's logo

  - `companies.hasCompanyEmployeesCount` (boolean)

  - `companies.hasCompanyRevenue` (boolean)

  - `companies.hasCompanyMainIndustry` (boolean)

  - `companies.hasCompanySubIndustry` (boolean)

  - `companies.hasCompanyFunding` (boolean)

  - `companies.hasCompanyIntent` (boolean)

  - `companies.hasCompanyTechnologies` (boolean)

  - `companies.hasCompanyCity` (boolean)

  - `companies.hasCompanyCountry` (boolean)

  - `companies.signalTypes` (array)
    Types of signals detected for this company
    Example: ["newsEvent"]

## Response 400 fields (application/json):

  - `statusCode` (integer, required)
    HTTP status code
    Example: 400

  - `message` (string, required)
    Error message
    Example: "Validation failed"

  - `errors` (array)
    Detailed error messages (optional, only for validation errors)
    Example: ["entityType must be one of: contact, company"]

## Response 401 fields (application/json):

  - `statusCode` (integer, required)
    HTTP status code
    Example: 400

  - `message` (string, required)
    Error message
    Example: "Validation failed"

  - `errors` (array)
    Detailed error messages (optional, only for validation errors)
    Example: ["entityType must be one of: contact, company"]

## Response 429 fields (application/json):

  - `statusCode` (integer, required)
    HTTP status code
    Example: 400

  - `message` (string, required)
    Error message
    Example: "Validation failed"

  - `errors` (array)
    Detailed error messages (optional, only for validation errors)
    Example: ["entityType must be one of: contact, company"]

## Response 500 fields (application/json):

  - `statusCode` (integer, required)
    HTTP status code
    Example: 400

  - `message` (string, required)
    Error message
    Example: "Validation failed"

  - `errors` (array)
    Detailed error messages (optional, only for validation errors)
    Example: ["entityType must be one of: contact, company"]