---
title: "Count"
method: POST
path: "/companies/search/count"
tags: ["Company / Search"]
---

# Count

`POST /companies/search/count`

## Request

- Base URL: `https://api.companyenrich.com`
- URL: `https://api.companyenrich.com/companies/search/count`
- Auth: API key in header `Authorization`

**Cost:** FREE - No credits deducted

Returns the total count of companies matching the given search criteria without retrieving the actual results.

## Request body

- CompanySearchInput
  - `lists` string[], nullable: The list IDs to filter by
  - `semanticQuery` string, nullable: The semantic search query to find companies with. More natural language version of the standard query.
  - `semanticWeight` number, double, nullable: The semantic weight to apply to the results. Must be between 0 and 1. 0.7 is default. Larger values will prioritize semantic similarity, smaller values will prioritize traditional search factors.
  - `exclude` CompanyExcludeFilters, nullable: Exclusion filters to apply on the companies. If a company matches any of the filters here, it will be excluded from the results.
    - `domains` string[], nullable: The domain names of companies to exclude from the results
    - `regions` string[], nullable: The region IDs to filter by
    - `countries` string[], nullable: The 2 letter country codes to filter by
    - `states` integer[], nullable: The state IDs to filter by
    - `cities` integer[], nullable: The city IDs to filter by
    - `type` CompanyType[], nullable: The list of company types to filter by
    - `category` CompanyCategory[], nullable: The list of company categories to filter by
    - `employees` CompanyEmployees[], nullable: The list of employee counts to filter by
    - `reportedEmployees` CompanyEmployees[], nullable: The list of externally reported employee counts to filter by
    - `revenue` CompanyRevenue[], nullable: The list of revenue ranges to filter by
    - `naicsCode` integer[], nullable: The NAICS codes to filter by. Can be 2 to 6 digit codes. In case of a 2-5 digit code, all 6 digit codes under it will be included
    - `keywords` string[], nullable: The keywords to filter by
    - `technologies` string[], nullable: The technologies to filter by
    - `fundingRounds` CompanyFundingRound[], nullable: The funding rounds to filter by
  - `query` string, nullable: The search query to apply on the company name and domain
  - `foundedYear` YearRange, nullable: The range of years
    - `min` integer, nullable: The minimum year (inclusive)
    - `max` integer, nullable: The maximum year (inclusive)
  - `fundingAmount` CompanyFundingAmountRange, nullable: The funding amount range to filter by
    - `min` number, double, nullable: The minimum funding amount (inclusive)
    - `max` number, double, nullable: The maximum funding amount (inclusive)
  - `fundingYear` YearRange, nullable: The range of years
    - `min` integer, nullable: The minimum year (inclusive)
    - `max` integer, nullable: The maximum year (inclusive)
  - `categoryOperator` unknown
  - `keywordsOperator` unknown
  - `technologiesOperator` unknown
  - `workforceGrowth` CompanyWorkforceGrowthInput, nullable: Filter companies by workforce growth percentage over a selected period and department.
    - `period` unknown
    - `department` unknown
    - `minPercent` number, double, nullable: The minimum workforce growth percentage (inclusive). Example: 15 means 15% growth, -10 means 10% decline.
    - `maxPercent` number, double, nullable: The maximum workforce growth percentage (inclusive). Example: 15 means 15% growth, -10 means 10% decline.
  - `workforceSize` CompanyWorkforceSizeInput[], nullable: Filter companies by absolute workforce headcount. Multiple entries can be provided to filter on different departments simultaneously.
    - `department` unknown
    - `min` integer, nullable: The minimum headcount (inclusive).
    - `max` integer, nullable: The maximum headcount (inclusive).
  - `require` FeatureRequirement[], nullable: The features that must exist for the company
  - `regions` string[], nullable: The region IDs to filter by
  - `countries` string[], nullable: The 2 letter country codes to filter by
  - `states` integer[], nullable: The state IDs to filter by
  - `cities` integer[], nullable: The city IDs to filter by
  - `type` CompanyType[], nullable: The list of company types to filter by
  - `category` CompanyCategory[], nullable: The list of company categories to filter by
  - `employees` CompanyEmployees[], nullable: The list of employee counts to filter by
  - `reportedEmployees` CompanyEmployees[], nullable: The list of externally reported employee counts to filter by
  - `revenue` CompanyRevenue[], nullable: The list of revenue ranges to filter by
  - `naicsCode` integer[], nullable: The NAICS codes to filter by. Can be 2 to 6 digit codes. In case of a 2-5 digit code, all 6 digit codes under it will be included
  - `keywords` string[], nullable: The keywords to filter by
  - `technologies` string[], nullable: The technologies to filter by
  - `fundingRounds` CompanyFundingRound[], nullable: The funding rounds to filter by

## Response `200`

OK

- integer

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `402`: Payment Required
- `422`: Unprocessable Entity
- `429`: Too Many Requests

---

[API](https://skmtc.dev/companyenrich/apis/company-enrich-api.md) - [All operations](https://skmtc.dev/companyenrich/apis/company-enrich-api/llms.txt) - [OpenAPI document](https://skmtc.dev/companyenrich/apis/company-enrich-api/revisions/07f84debab87?raw)