# Search Companies

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


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-40)

  - `filters` (object, required)

  - `filters.companies` (object)

  - `filters.companies.include` (object)

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

  - `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.sicsCodes` (array)
    Example: ["1011","1021"]

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

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

## Response 400 fields (application/json):

  - `error` (object, required)

  - `error.code` (integer, required)
    HTTP status code

  - `error.message` (string, required)
    Error message

## Response 401 fields (application/json):

  - `error` (object, required)

  - `error.code` (integer, required)
    HTTP status code

  - `error.message` (string, required)
    Error message

## Response 429 fields (application/json):

  - `error` (object, required)

  - `error.code` (integer, required)
    HTTP status code

  - `error.message` (string, required)
    Error message

## Response 500 fields (application/json):

  - `error` (object, required)

  - `error.code` (integer, required)
    HTTP status code

  - `error.message` (string, required)
    Error message