Search Filters: Base Company API

Data type:

Query type:

URL:

Base Company

Coresignal's custom filters

https://api.coresignal.com/cdapi/v2/company_base/search/filter

---

Overview

Use the endpoint to discover company IDs. It offers a less complex user experience than the /v2/company_base/search/es_dsl endpoint.

Explore the available filters, their potential applications, and helpful tips.

If you prefer uncomplicated queries, opt for this endpoint. Below are details about filter explanations and how to use them.

Endpoint structure

Full structure

{
  "name": "string",
  "website": "string",
  "exact_website": "string",
  "size": "string",
  "industry": "string",
  "country": "string",
  "location": "string",
  "created_at_gte": "string",
  "created_at_lte": "string",
  "last_updated_gte": "string",
  "last_updated_lte": "string",
  "deleted": true,
  "employees_count_gte": 0,
  "employees_count_lte": 0,
  "source_id": 0,
  "founded_year_gte": 0,
  "founded_year_lte": 0,
  "funding_total_rounds_count_gte": 0,
  "funding_total_rounds_count_lte": 0,
  "funding_last_round_type": "string",
  "funding_last_round_date_gte": "string",
  "funding_last_round_date_lte": "string"
}

Filter list

All personal/company information mentioned within this context is entirely fictional and is solely intended for illustrative purposes.

---

Example outputs are redacted and may not contain all the fields you would receive using the endpoint.

name

Filter name	Data input type	Description	Usage
name	String	Company name	Find company records using the company name or parts of it. Available operators: AND (both keywords need to be present) OR (one or the other keyword is present).

You can search for company records using a part of the name.

For instance, entering IT will return results with companies such as Backbone IT Consulting Inc. and Brothers IT Limited.

Example input:

name

{
  "name": "IT"
}

OR operator

{
  "name": "(IT Consulting) OR (IT Security)"
}

AND operator

{
  "name": "(IT Consulting) AND (IT Security)"
}

Use "(first phrase) OR (second phrase)" if you are searching for words in a phrase and want them to be interpreted together.

Example output:

First example

{
    "id": 482,
    "name": "IT Consulting Inc.",
}

website

Filter name	Data input type	Description	Usage
website	String	Company's website	Search for company records using the company's website. Possible URL formats include: microsoft.com subdomain.microsoft.com www.microsoft.com https://www.microsoft.com .

Example input:

Domain

{
  "website": "example-company.com"
}

https format

{
  "website": "https://www.example-company.com"
}

Example output:

Example

"name": "Example Company",
"website": "www.example-company.com",

exact_website

Filter name	Data input type	Description	Usage
exact_website	String	Company's website	Search for company records using the (exact) company website. Possible URL formats: microsoft.com www.microsoft.com https://www.microsoft.com

Example input:

exact_website

{
  "name": "IT Company",
  "exact_website": "www.it-company.com"
}

Example output:

Example

    "name": "IT Company",
    "website": "http://www.it-company.com",

size

Filter name	Data input type	Description	Usage
size	String	Company size (based on headcount)	Find company profiles based on their size.

Possible input values can be found in general Search filters topic.

industry

Filter name	Data input type	Description	Usage
industry	String	Associated industry	Use the associated industry values to find company profiles. Search based on the available industry list. Available operators: AND (both keywords need to be present) OR (one or the other keyword is present in the data).

Use "(first phrase) OR (second phrase)" if you are searching for words in a phrase and want them to be interpreted together.

Phrases

{
  "industry": "(Information technology) OR Internet"
}

Possible input values can be found in general Search filters topic.

country

Filter name	Data input type	Description	Usage
country	String	Country where the company is based	Use any of the possible country values to find company records. Available operators: * OR (one of the two input values)

Use "(first phrase) OR (second phrase)" if you are searching for words in a phrase and want them to be interpreted together.

Phrases

{
  "country": "(United Kingdom) OR Germany"
}

Possible input values can be found in general Search filters topic.

location

Filter name	Data input type	Description	Usage
location	String	Company location	Use the following values to search for company records: continent (e.g., North America) country (e.g., United States) state (e.g., Florida) city (e.g., Jacksonville) village (e.g., Palmetto bay). Available operators: AND – both keywords need to be present; OR – one or the other keyword is present.

Example input:

location

{
  "location": "United States, Florida"
}

Example output:

Output

"headquarters_new_address": "Palmetto Bay, Miami, Florida, United States",

Use "\"{keyword}\"" format to find exact matches.

Exact match

{
  "location": "\"United States\" OR Germany"
}

created_at_gte

Filter name	Data input type	Description	Usage
created_at_gte	String	Date and time when the record was created in our database	Find company records based on the creation date. Use the YYYY-MM-DD hh:mm:ss date format. The output value will be greater than or equal to the input value.

Example input:

created_at_gte

{
  "created_at_gte": "2021-06-26 12:21:01"
}

Example output:

Example

  "created": "2021-06-26 12:21:06",

created_at_lte

Filter name	Data input type	Description	Usage
created_at_lte	String	Date and time when the record was created in our database	Find company records based on the creation date. Use the YYYY-MM-DD hh:mm:ss date format. The output data will be less than or equal to the input value.

Example input:

created_at_lte

{
  "created_at_lte": "2021-06-26 12:21:01"
}

Example output:

Example

 "created": "2016-06-17 14:59:01",

last_updated_gte

Filter name	Data input type	Description	Usage
last_updated_gte	String	Date and time when the record was last updated	Find company records based on the last update date. Use the YYYY-MM-DD hh:mm:ss date format. The output value will be greater than or equal to the input value.

Example input:

last_updated_gte

{
  "last_updated_gte": "2021-02-26 12:41:01"
}

Example output:

Example

"last_updated": "2023-05-21 17:58:40",
"last_response_code": 200,

last_updated_lte

Filter name	Data input type	Description	Usage
last_updated_lte	String	Date and time when the record was last updated	Find company records based on the last update date. Use the YYYY-MM-DD hh:mm:ss date format. The output value will be less than or equal to the input value.

Example input:

last_updated_lte

{
  "last_updated_lte": "2023-02-26 12:41:01"
}

Example output:

Example

"last_updated": "2023-01-09 05:01:35",
"last_response_code": 200,

deleted

Filter name	Data input type	Description	Usage
deleted	Boolean	Marks record's public availability	Use it to see company records that are deleted or private. Use the value true to include deleted/private profiles or false to exclude such profiles from your search. Tip: Combine with other filters using relevant keywords.

Input values:

deleted – true

{
  "deleted": true
}

deleted – false

{
  "deleted": false
}

Example output:

Deleted profile

{
    "deleted": 1
}

employees_count_gte

Filter name	Data input type	Description	Usage
employees_count_gte	Integer	Employee count visible on the company's profile	Find company records based on the company headcount. The output value will be greater than or equal to the input value.

Example input:

employees_count_gte

{
  "employees_count_gte": 22
}

Example output:

Example

"employees_count": 190,

employees_count_lte

Filter name	Data input type	Description	Usage
employees_count_gte	Integer	Employee count visible on the company's profile	Find company records based on the company headcount. The output value will be less than or equal to the input value.

Example input:

employees_count

{
  "employees_count_lte": 22
}

Example output:

Example

"employees_count": 2,

source_id

Filter name	Data input type	Description	Usage
source_id	Integer	Company ID assigned by the source	Find company records using source identifiers.

Example input:

source_id

{
  "source_id": 2280242
}

Example output:

Example

"id": 5,
"url": "https://www.professional-network.com/company/it-company",
"hash": "7c7aa7f01abcc2c5672ae36fc412cff9",
"name": "ITcompany",
"source_id": 2280242,

founded_year_gte

Filter name	Data input type	Description	Usage
founded_year_gte	Integer	Company's founding year	Find company records based on their founding year. The output value will be greater than or equal to the input value.

Example input:

founded_year

{
  "founded_year_gte": 2011
}

Example output:

Example

"founded": 2015,

founded_year_lte

Filter name	Data input type	Description	Usage
founded_year_lte	Integer	Company's founding year	Find company records based on their founding year. The output value will be less than or equal to the input value.

Example input:

founded_year_lte

{
  "founded_year_lte": 2011 
}

Example output:

Example

"founded": 2001,

funding_total_rounds_count_gte

Filter name	Data input type	Description	Usage
funding_total_rounds_count_gte	Integer	Total number of company's funding rounds	Find company records based on the funding rounds in the company's financial history. The output value will be greater than or equal to the input value.

Example input:

funding_rounds_total_count

{
  "funding_total_rounds_count_gte": 5
}

Example input:

Example

"company_funding_rounds_collection": [
        {
            "id": 81212,
            "last_round_investors_count": 0,
            "total_rounds_count": 5,
            "last_round_type": "Seed",
            "last_round_date": "2016-11-21 00:00:00",
            "last_round_money_raised": "US$ 1.6M",
            "financial_website_url": "https://www.financial_website.com/funding_round/it-company",
            "created": "2020-09-15 10:22:31",
            "last_updated": "2020-10-17 23:02:42",
            "deleted": 1
        }
  ]

funding_total_rounds_count_lte

Filter name	Data input type	Description	Usage
funding_total_rounds_count_lte	Integer	Total number of company's funding rounds	Find company records based on the funding rounds in the company's financial history. The output value will be less than or equal to the input value.

Example input:

funding_total_rounds_count

{
  "funding_total_rounds_count_lte": 5
}

Example output:

Example

"company_funding_rounds_collection": [
        {
            "id": 9707,
            "last_round_investors_count": 0,
            "total_rounds_count": 0,
            "last_round_type": null,
            "last_round_date": null,
            "last_round_money_raised": null,
            "financial_website_url": null,
            "created": "2020-09-07 19:44:55",
            "last_updated": "2020-10-30 09:03:58",
            "deleted": 1
        }
    ]

funding_last_round_type

Filter name	Data input type	Description	Usage
funding_last_round_type	String	Last funding round type	Find company records based on the company's last funding round. Use any of the possible input values.

Possible input values can be found in general Search filters topic.

funding_last_round_date_gte

Filter name	Data input type	Description	Usage
funding_last_round_date_gte	String	Last funding round date	Use the last funding round date to find relevant company records. Use the yyyy-mm-dd date format. The output value will be greater than or equal to the input value.

Example input:

funding_last_round_date_gte

{
  "funding_last_round_date_gte": "2021-11-01"
}

Example output:

Example

"company_funding_rounds_collection": [
        {
            "id": 81212,
            "last_round_investors_count": 0,
            "total_rounds_count": 5,
            "last_round_type": "Seed",
            "last_round_date": "2016-11-21 00:00:00",
            "last_round_money_raised": "US$ 1.6M",
            "financial_website_url": "https://www.financial_website.com/funding_round/it-company",
            "created": "2020-09-15 10:22:31",
            "last_updated": "2020-10-17 23:02:42",
            "deleted": 1
        }
    ]

funding_last_round_date_lte

Filter name	Data input type	Description	Usage
funding_last_round_date_gte	String	Last funding round date	Use the last funding round date to find relevant company records. Use the yyyy-mm-dd date format. The output value will be less than or equal to the input value.

Example input:

funding_last_round_date_lte

{
  "funding_last_round_date_lte": "2011-11-01"
}

Example output:

Example

"company_funding_rounds_collection": [
        {
            "id": 121691,
            "last_round_investors_count": 0,
            "total_rounds_count": 1,
            "last_round_type": "Angel",
            "last_round_date": "2007-01-01 00:00:00",
            "last_round_money_raised": null,
            "financial_website_url": "https://www.financial_website.com/funding_round/it-company",
            "created": "2020-09-20 23:18:01",
            "last_updated": "2020-10-13 08:17:36",
            "deleted": 1
        }
  ]

Sample request

Request example

curl -X 'POST' \
'https://api.coresignal.com/cdapi/v2/company_base/search/filter' \
  -H 'accept: application/json' \
  -H 'apikey: {API Key}' \
  -H 'Content-Type: application/json' \
  -d '{
  "industry": "Information technology",
  "created_at_gte": "2024-01-01 00:00:01",
  "last_updated_gte": "2026-03-01 00:00:01"
}'