Company API
Endpoints

Search Filters

14min

Data type: Company Query type: Coresignal's custom filters URL: /v1​/professional_network/company/search​/filter.

Use the endpoint to discover employee IDs. It offers a less complex user experience than the /v1/professional_network/company/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


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.

Response codes

See the list of possible error codes.

Request examples

Test out the endpoint with suggested examples.

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.

name
OR operator
AND operator


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
Second example


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
https format


Example output:

Example


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

exact_website


Example output:

Example


Filter name

Data input type

Description

Usage

size

String

Company size (based on headcount)

Find company profiles based on their size.

Possible input values:

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


Possible input values:

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


Possible input list:

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

You can additionally combine several of the location values, e.g.,

  • continent, country (United States, North America)
  • country, state, city (United States, Florida, Miami)
  • city, state (Jacksonville Beach, Florida)
  • village, city, state, country (Palmetto Bay, Miami, Florida, United States)

Available operators:

  • AND (both keywords need to be present)
  • OR (one of the two input values).

Example input:

location


Example output:

Output


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

Exact match


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


Example output:

Example


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


Example output:

Example


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


Example output:

Example


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


Example output:

Example


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


Example output:

Example


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


Example output:

Example


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


Example output:

Example


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


Example output:

Example


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


Example output:

Example


Filter name

Data input type

Description

funding_total_rounds_count_gte

Integer

Total number of company's funding rounds

Usage

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


Example input:

Example


Filter name

Data input type

Description

funding_total_rounds_count_lte

Integer

Total number of company's funding rounds

Usage

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


Example output:

Example


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:

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


Example output:

Example


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


Example output:

Example










Updated 12 Sep 2024
Did this page help you?
PREVIOUS
Endpoints
NEXT
Pagination
Docs powered by Archbee