> For the complete documentation index, see [llms.txt](https://docs.coresignal.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.coresignal.com/company-data/api/search-filters.md).

# Search Filters: Company API

Filter multi-source company records with named request parameters, exclusions, and free-text operators.

{% columns %}
{% column width="16.666666666666664%" %}
Data type:

Query type:

URLs:
{% endcolumn %}

{% column %}
Company data

Coresignal's custom filters

<https://api.coresignal.com/cdapi/v2/company\\_multi\\_source/search/filter>
{% endcolumn %}
{% endcolumns %}

***

The Company API provides structured, parameter-based filtering endpoints for multi-source company data. Rather than constructing custom Elasticsearch DSL queries, you can pass standard, named key-value filters directly in the request body. Each filter parameter maps to the response field it filters.

## Universal operator rules

These evaluation rules apply across all parameters:

* Single value vs. list:
  * Providing a single value evaluates as an exact match (`equals`).
  * Providing an array/list of values evaluates as `any of` (logical `OR` within that field).
* Cross-parameter combination:
  * Multiple parameters are combined using `AND` logic.
  * Cross-field `OR` is not supported. If your query requires logical `OR` across different fields, use standard Elasticsearch DSL endpoints instead.
* Exclusions (`exclude_`):
  * Any parameter prefixed with `exclude_` acts as a negative match (`NOT`).
* Null values:
  * Passing an explicit `null` targets records that contain no value for that specific field.
  * Explicit `null` values are not permitted on `exclude_` parameters.
* Error handling and unknown parameters:
  * Any unrecognized or invalid parameter name will trigger a `422` error that explicitly names the offending parameter.

### Free-text search operators

Free-text fields (such as `description`, `categories_and_keywords`, and `technologies_used`) support symbol-based query operators:

| Operator | Action              | Example                          |
| -------- | ------------------- | -------------------------------- |
| `\|`     | Logical OR          | `Software \| Internet`           |
| `+`      | Logical AND         | `Python + Django`                |
| `-`      | Logical NOT         | `Cloud -AWS`                     |
| `""`     | Exact phrase match  | `"Artificial Intelligence"`      |
| `()`     | Precedence grouping | `(Fintech \| Payments) + Mobile` |

{% hint style="warning" %}

#### Important: syntax differences

Text words `OR`, `AND`, and `NOT` are not interpreted as operators in this API – they are treated as literal search terms. You must use the symbols `|`, `+`, and `-`.

A malformed free-text operator syntax does not raise an API error. It will result in fewer or zero matching records.
{% endhint %}

## Filter reference

The filters below are grouped into categories to help you find the right parameter faster.

### Name and web identifiers

<table><thead><tr><th width="294.7109375">Parameter</th><th width="130.078125">Type</th><th>Description</th></tr></thead><tbody><tr><td><code>name</code></td><td>String</td><td>Company name</td></tr><tr><td><code>exact_name</code></td><td>String</td><td>Whole company name, case-sensitive</td></tr><tr><td><code>website</code></td><td>String</td><td>Domain or website match</td></tr><tr><td><code>exact_website</code></td><td>String</td><td>Exact website URL match</td></tr><tr><td><code>professional_network_url</code></td><td>String</td><td>URL to the company's profile on professional network</td></tr></tbody></table>

### Location and geographic data

<table><thead><tr><th width="295.421875">Parameter</th><th width="129.53515625">Type</th><th>Description</th></tr></thead><tbody><tr><td><code>hq_location</code></td><td>String</td><td>Full location search string</td></tr><tr><td><code>hq_country</code></td><td>String</td><td>Full country name match. Matches individual words: searching <code>"States"</code> matches <code>"United States"</code></td></tr><tr><td><code>exact_hq_country</code></td><td>String</td><td>Full country name match, case-insensitive, matches the entire country name string</td></tr><tr><td><code>hq_country_iso2</code></td><td>String</td><td>2-letter ISO 3166-1 alpha-2 country code (e.g., <code>US</code>, <code>CA</code>, <code>DE</code>)</td></tr><tr><td><code>hq_state</code></td><td>String</td><td>Headquarters state</td></tr><tr><td><code>hq_city</code></td><td>String</td><td>Headquarters city name</td></tr></tbody></table>

### Industry, classification and size

<table data-search="false"><thead><tr><th width="294.828125">Parameter</th><th width="129.7734375">Type</th><th>Description</th></tr></thead><tbody><tr><td><code>industry</code></td><td>String</td><td>High-level industry sector</td></tr><tr><td><code>exact_industry</code></td><td>String</td><td>Specific industry taxonomy match. Find all available <code>exact_industry</code> values on a general <a href="https://docs.coresignal.com/api-introduction/requests/search-filters.md#possible-input-values">Search Filter</a> page</td></tr><tr><td><code>type</code></td><td>String</td><td>Company type. Available values: <code>Self-Employed</code>, <code>Privately Held</code>, <code>Self-Owned</code>, <code>Nonprofit</code>, <code>Public Company</code>, <code>Partnership</code>, <code>Government Agency</code>, <code>Educational</code></td></tr><tr><td><code>size_range</code></td><td>String</td><td>Company size range. Find all available <code>size_range</code> values on a general <a href="https://docs.coresignal.com/api-introduction/requests/search-filters.md#possible-input-values">Search Filter</a> page</td></tr><tr><td><code>employees_count_gte</code></td><td>Integer</td><td>Minimum employee count in a company (<span class="math">≥</span>)</td></tr><tr><td><code>employees_count_lte</code></td><td>Integer</td><td>Maximum employee count in a company (<span class="math">≤</span>)</td></tr><tr><td><code>founded_year_gte</code></td><td>Integer</td><td>Earliest founding year of a company (<span class="math">≥</span>). Must be a 4-digit year (e.g., <code>1998</code>)</td></tr><tr><td><code>founded_year_lte</code></td><td>Integer</td><td>Latest founding year of a company (<span class="math">≤</span>). Must be a 4-digit year (e.g., <code>2024</code>)</td></tr></tbody></table>

### Business attributes and model

<table data-search="false"><thead><tr><th width="295.34765625">Parameter</th><th width="129.5">Type</th><th>Description</th></tr></thead><tbody><tr><td><code>is_b2b</code></td><td>Boolean</td><td>Flag indicating whether the company operates in the B2B space (<code>true</code> / <code>false</code>)</td></tr><tr><td><code>is_public</code></td><td>Boolean</td><td>Flag indicating whether the company is publicly traded (<code>true</code> / <code>false</code>)</td></tr><tr><td><code>is_saas</code></td><td>Boolean</td><td>Flag indicating whether the company provides SaaS solutions (<code>true</code> / <code>false</code>)</td></tr><tr><td><code>business_model</code></td><td>String</td><td>Specific business models (e.g., <code>B2B</code>, <code>B2C</code>)</td></tr><tr><td><code>business_areas</code></td><td>String</td><td>Business areas the employer operates in</td></tr><tr><td><code>offerings</code></td><td>String</td><td>Products, solutions, and services offered</td></tr><tr><td><code>description</code></td><td>String</td><td>Description of the company. Accepts symbol operators</td></tr><tr><td><code>categories_and_keywords</code></td><td>String</td><td>Keywords and category tags associated with the company. Accepts symbol operators</td></tr></tbody></table>

### Technologies and job postings

<table><thead><tr><th width="295.05859375">Parameter</th><th width="129.94140625">Type</th><th>Description</th></tr></thead><tbody><tr><td><code>technologies_used</code></td><td>String</td><td>Text search across detected tech stacks and tools. Accepts symbol operators</td></tr><tr><td><code>active_job_postings_count_gte</code></td><td>Integer</td><td>Minimum number of active job openings in a company (<span class="math">≥</span>)</td></tr><tr><td><code>active_job_postings_count_lte</code></td><td>Integer</td><td>Maximum number of active job openings in a company (<span class="math">≤</span>)</td></tr><tr><td><code>active_job_postings_title</code></td><td>String</td><td>Open job titles at companies</td></tr></tbody></table>

### Financials and funding

<table><thead><tr><th width="294.64453125">Parameter</th><th width="129.87890625">Type</th><th>Description</th></tr></thead><tbody><tr><td><code>revenue_gte</code></td><td>Integer</td><td>Minimum annual revenue (<span class="math">≥</span>). Matches if either available revenue source meets the threshold</td></tr><tr><td><code>revenue_lte</code></td><td>Integer</td><td>Maximum annual revenue (<span class="math">≤</span>). Matches if either available revenue source falls within the threshold</td></tr><tr><td><code>last_funding_round_type</code></td><td>String</td><td>Company's last funding round type. Broader terms include subsets, e.g., <code>"Seed"</code> also matches <code>"Pre-Seed"</code>. Find available <code>last_funding_round_type</code> values on a general <a href="https://docs.coresignal.com/api-introduction/requests/search-filters.md#possible-input-values">Search Filter</a> page</td></tr><tr><td><code>last_funding_round_date_gte</code></td><td>String</td><td>Earliest company's funding round date (<code>YYYY-MM-DD</code>)</td></tr><tr><td><code>last_funding_round_date_lte</code></td><td>String</td><td>Latest company's funding round date (<code>YYYY-MM-DD</code>)</td></tr></tbody></table>

### System and metadata

<table><thead><tr><th width="294.8515625">Parameter</th><th width="129.5625">Type</th><th>Description</th></tr></thead><tbody><tr><td><code>created_at_gte</code></td><td>String</td><td>Minimum record creation date. <code>YYYY-MM-DD</code> and <code>YYYY-MM-DD HH:MM:SS</code> formats are accepted</td></tr><tr><td><code>created_at_lte</code></td><td>String</td><td>Maximum record creation date. <code>YYYY-MM-DD</code> and <code>YYYY-MM-DD HH:MM:SS</code> formats are accepted</td></tr><tr><td><code>last_updated_at_gte</code></td><td>String</td><td>Last update date of the record (<code>YYYY-MM-DD</code>). <code>YYYY-MM-DD</code> and <code>YYYY-MM-DD HH:MM:SS</code> formats are accepted</td></tr><tr><td><code>last_updated_at_lte</code></td><td>String</td><td>Latest update date of the record (<code>YYYY-MM-DD</code>). <code>YYYY-MM-DD</code> and <code>YYYY-MM-DD HH:MM:SS</code> formats are accepted</td></tr><tr><td><code>source_id</code></td><td>String</td><td>Primary record source identifier.</td></tr></tbody></table>

### Exclusion variants

Prefix a field with `exclude_` to omit records matching those criteria.

<table data-search="false"><thead><tr><th width="295.40625">Exclusion parameter</th><th width="129.640625">Type</th><th>Description</th></tr></thead><tbody><tr><td><code>exclude_name</code></td><td>String</td><td>Exclude companies by name</td></tr><tr><td><code>exclude_exact_name</code></td><td>String</td><td>Exclude companies by exact, case-sensitive name</td></tr><tr><td><code>exclude_website</code></td><td>String</td><td>Exclude companies by website</td></tr><tr><td><code>exclude_hq_country_iso2</code></td><td>String</td><td>Exclude companies by 2-letter ISO country code</td></tr><tr><td><code>exclude_hq_country</code></td><td>String</td><td>Exclude companies by headquarters country</td></tr><tr><td><code>exclude_exact_hq_country</code></td><td>String</td><td>Exclude companies by exact country name</td></tr><tr><td><code>exclude_industry</code></td><td>String</td><td>Exclude general industries</td></tr><tr><td><code>exclude_exact_industry</code></td><td>String</td><td>Exclude specific industries</td></tr><tr><td><code>exclude_type</code></td><td>String</td><td>Exclude company types</td></tr><tr><td><code>exclude_description</code></td><td>String</td><td>Exclude records containing specific text terms or phrases in a description</td></tr><tr><td><code>exclude_categories_and_keywords</code></td><td>String</td><td>Exclude matching keywords or categories</td></tr><tr><td><code>exclude_business_areas</code></td><td>String</td><td>Exclude operational areas</td></tr><tr><td><code>exclude_offerings</code></td><td>String</td><td>Exclude specific product/service offerings</td></tr><tr><td><code>exclude_technologies_used</code></td><td>String</td><td>Exclude companies using specific tools or technologies</td></tr></tbody></table>

## Complete request schema

{% code title="Request schema for Company API search filters" lineNumbers="true" expandable="true" %}

```json
{
  "name": "string",
  "exact_name": "string",
  "website": "string",
  "exact_website": "string",
  "professional_network_url": "string",
  "hq_country_iso2": "US",
  "hq_city": "string",
  "hq_state": "string",
  "hq_location": "string",
  "hq_country": "string",
  "exact_hq_country": "string",
  "industry": "string",
  "exact_industry": "string",
  "size_range": "51-200",
  "employees_count_gte": 0,
  "employees_count_lte": 0,
  "founded_year_gte": 1900,
  "founded_year_lte": 2026,
  "type": "string",
  "is_b2b": true,
  "is_public": true,
  "is_saas": true,
  "business_model": "string",
  "description": "string",
  "categories_and_keywords": "string",
  "business_areas": "string",
  "offerings": "string",
  "technologies_used": "string",
  "active_job_postings_count_gte": 0,
  "active_job_postings_count_lte": 0,
  "active_job_postings_title": "string",
  "revenue_gte": 0,
  "revenue_lte": 0,
  "last_funding_round_type": "string",
  "last_funding_round_date_gte": "YYYY-MM-DD",
  "last_funding_round_date_lte": "YYYY-MM-DD",
  "created_at_gte": "YYYY-MM-DD",
  "created_at_lte": "YYYY-MM-DD",
  "last_updated_at_gte": "YYYY-MM-DD",
  "last_updated_at_lte": "YYYY-MM-DD",
  "source_id": "string",
  "exclude_name": "string",
  "exclude_exact_name": "string",
  "exclude_website": "string",
  "exclude_hq_country_iso2": "US",
  "exclude_hq_country": "string",
  "exclude_exact_hq_country": "string",
  "exclude_industry": "string",
  "exclude_exact_industry": "string",
  "exclude_type": "string",
  "exclude_description": "string",
  "exclude_categories_and_keywords": "string",
  "exclude_business_areas": "string",
  "exclude_offerings": "string",
  "exclude_technologies_used": "string"
}
```

{% endcode %}

## Sample query

Fetch records for Canadian software companies while filtering out nonprofits:

{% code title="Bash" %}

```json
curl -X 'POST' \
  'https://api.coresignal.com/cdapi/v2/company_multi_source/search/filter' \
  -H 'accept: application/json' \
  -H 'apikey: {API_KEY}' \
  -H 'Content-Type: application/json' \
  -d '{
    "industry": "Software Development",
    "exclude_type": "Nonprofit",
    "hq_country": "Canada"
  }'
```

{% endcode %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.coresignal.com/company-data/api/search-filters.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
