---
title: "Count search results"
method: POST
path: "/search/count"
tags: ["search"]
---

# Count search results

`POST /search/count`

## Request

- Base URL: `https://api.leadsforge.ai`
- URL: `https://api.leadsforge.ai/search/count`
- Auth: `ApiKeyAuth` (a scheme the document does not define)

Count leads matching a filter set. Accepts the same filter payload as POST /search except the limit field, and returns the total number of matches without paginating results. Useful for sizing the audience before launching a search.

## Request body

- PersonSearchFilters
  - `companyBusinessModels` IncludeExcludeFilter
    - `exclude` string[]
    - `include` string[]
  - `companyDomains` IncludeExcludeFilter
    - `exclude` string[]
    - `include` string[]
  - `companyEmployeeNumberRange` MinMaxFilter
    - `max` integer
    - `min` integer
  - `companyFoundedYearRange` MinMaxFilter
    - `max` integer
    - `min` integer
  - `companyFundingRounds` IncludeExcludeFilter
    - `exclude` string[]
    - `include` string[]
  - `companyIDs` IncludeExcludeFilter
    - `exclude` string[]
    - `include` string[]
  - `companyIndustries` IncludeExcludeFilter
    - `exclude` string[]
    - `include` string[]
  - `companyKeywords` IncludeExcludeAllFilter
    - `exclude` string[]
    - `include` string[]
    - `matchAll` boolean
  - `companyLocations` IncludeExcludeFilter
    - `exclude` string[]
    - `include` string[]
  - `companyNames` IncludeExcludeFilter
    - `exclude` string[]
    - `include` string[]
  - `companyNiches` IncludeExcludeFilter
    - `exclude` string[]
    - `include` string[]
  - `companyRequired` boolean
  - `companyRevenueRanges` RevenueCategory[]
  - `companyTechnologies` AnyAllFilter
    - `all` string[]
    - `any` string[]
  - `companyTypes` IncludeExcludeFilter
    - `exclude` string[]
    - `include` string[]
  - `companyYearsInBusinessRange` MinMaxFilter
    - `max` integer
    - `min` integer
  - `leadDepartments` IncludeExcludeFilter
    - `exclude` string[]
    - `include` string[]
  - `leadIDs` IncludeExcludeFilter
    - `exclude` string[]
    - `include` string[]
  - `leadJobTitles` JobTitleFilter
    - `exactMatch` boolean
    - `exclude` string[]
    - `include` string[]
  - `leadLanguages` LanguageFilter
    - `exclude` string[]
    - `include` string[]
    - `primaryOnly` boolean
  - `leadLocations` IncludeExcludeFilter
    - `exclude` string[]
    - `include` string[]
  - `leadSeniorities` IncludeExcludeFilter
    - `exclude` string[]
    - `include` string[]
  - `leadTenure` MinMaxFilter
    - `max` integer
    - `min` integer
  - `maxContactsPerCompany` integer

## Response `200`

Count response

- SearchCountResponse
  - `totalCount` integer
  - `warnings` FilterWarning[]
    - `filter` string
    - `value` string

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `429`: Too Many Requests
- `500`: Internal Server Error

---

[API](https://skmtc.dev/leadsforge/apis/leadsforge-api.md) - [All operations](https://skmtc.dev/leadsforge/apis/leadsforge-api/llms.txt) - [OpenAPI document](https://skmtc.dev/leadsforge/apis/leadsforge-api/revisions/b4a6596215b5?raw)