Search Filters
roData type: Employee Query type: Coresignal's custom filters URL: /v1/professional_network/employee/search/filter.
Use the endpoint to discover employee IDs. This endpoint offers a less complex user experience than the /v1/professional_network/employee/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.
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.
See the list of possible error codes.
Test out the endpoint with suggested examples.
Filter name | Data input type | Description | Usage |
|---|---|---|---|
name | String | Employee's name | Use it to find employee records based on the name, surname, or full name. |
Example input:
Example output with corresponding fields in the output data:
Filter name | Data input type | Description | Usage |
|---|---|---|---|
title | String | Employee's title (Profile headline) | Use it to find employee records based on the profile headline (title). Available operators:
|
Example input:
Use "(first phrase) OR (second phrase)" if you are searching for words in a phrase and want them to be interpreted together.
Example output:
Use "\"{keyword}\"" format to find exact matches.
Filter name | Data input type | Description | Usage |
|---|---|---|---|
location | String | Employee's location | Use it to find employee records based on location. Use states, cities, and countries. |
Example input:
Example output:
Filter name | Data input type | Description | Usage |
|---|---|---|---|
industry | String | Associated industry Note: not directly related to any particular work experience | Use to find employee records based on the associated industry. Search based on the available list of industries. Available operators:
|
Use "(first phrase) OR (second phrase)" if you are searching for words in a phrase and want them to be interpreted together.
Possible input values:
Filter name | Data input type | Description | Usage |
|---|---|---|---|
summary | String | Education/work experience summary | Use it to find employee records based on the education/work experience summary. Available operators:
|
You can use the operator * to finish the keyword. For example, "py" will return results with py visible in them in them. Py*will return results with the completed word, e.g., Python.
Example input:
Use "(first phrase) OR (second phrase)" if you are searching for words in a phrase and want them to be interpreted together.
Example output:
Filter name | Data input type | Description | Usage |
|---|---|---|---|
created_at_gte | String | Date and time when the record was created in our database | Find employee 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:
Example output:
Filter name | Data input type | Description | Usage |
|---|---|---|---|
created_at_lte | String | Date and time when the record was created in our database | Find employee records based on the creation 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:
Example output:
Filter name | Data input type | Description | Usage |
|---|---|---|---|
last_updated_gte | String | Date and time when the record was last updated | Find employee 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:
Example output:
Filter name | Data input type | Description | Usage |
|---|---|---|---|
last_updated_lte | string | Date and time when the record was last updated | Find employee 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:
Example output:
Filter name | Data input type | Description | Usage |
|---|---|---|---|
deleted | Boolean | Marks record's public availability | Use it to see employee records that are deleted or private. Use the value true to include deleted/private employee profiles or false to exclude such profiles from your search. Tip: Combine with other filters using relevant keywords. |
Possible input values:
Example output:
Filter name | Data input type | Description | Usage |
|---|---|---|---|
country | String | Employee's country, parsed by us from the location value | Use it to find employee records based on location. Search based on the parsed location list. Available operators:
|
Use "(first phrase) OR (second phrase)" if you are searching for words in a phrase and want them to be interpreted together.
Possible input values:
Filter name | Data input type | Description | Usage |
|---|---|---|---|
skill | String | Employee's skills | Use it to find employee records based on relevant skills. Available operators:
|
You can use a part of the keyword with the operator *. In this case, you will see words that start with py.
Example input:
Use "(first phrase) OR (second phrase)" if you are searching for words in a phrase and want them to be interpreted together.
Example output:
Use "\"{keyword}\"" format to find exact matches.
Filter name | Data input type | Description | Usage |
|---|---|---|---|
certification_name | String | Employee's certifications | Use it to find employee records based on held certifications. Available operators:
|
You can use a part of the keyword with the operator *. In this case, you will see words that start with pyas, the certification name.
Example input:
Use "(first phrase) OR (second phrase)" if you are searching for words in a phrase and want them to be interpreted together.
Example output:
Use "\"{keyword}\"" format to find exact matches.
Filter name | Data input type | Description | Usage |
|---|---|---|---|
experience_title | String | Job title in the experience record | Use it to find employee records based on relevant work experience. Available operators:
|
You can use a part of the keyword with the operator *. In this case, you will see words that start with pyas the experience title.
Example input:
Use "(first phrase) OR (second phrase)" if you are searching for words in a phrase and want them to be interpreted together.
Example output:
Use "\"{keyword}\"" format to find exact matches.
Filter name | Data input type | Description | Usage |
|---|---|---|---|
experience_company_name | String | Current or previous workplace | Use it to find employee records based on the relevant workplace. Available operators:
|
Tip: you can use phrases or words you want to see in the company name. For example, using ITwill find all employee profiles with experience in a company using "IT" in their name.
Example input:
Use "(first_company) OR/AND (second_company)" when including several company names in the query.
Example output:
Filter name | Data input type | Description |
|---|---|---|
experience_company_exact_name | String | Exact name of the current or previous workplace |
Usage |
|---|
Use it to find employee records based on the relevant workplace. The output value will match the provided company name (e.g., bothMicrosoft and microsoft will work for the filter). |
The filter returns an exact match with the input value. For example, if you input Mas the value to look for, you get all employee profiles with a company named "M" listed on their profile.
Example output:
Filter name | Data input type | Description |
|---|---|---|
experience_company_website_url | String | Website of the current or previous workplace |
Usage |
|---|
Use it to find employee records based on the relevant workplace. Possible URL formats: www.example-company.com https://www.example-company.com. Any other format will return no results, even though your query will be shown as successful (200 response code). |
Example input:
Example output:
Filter name | Data input type | Description |
|---|---|---|
experience_company_website_exact_url | String | The exact website of the current or previous workplace |
Usage |
|---|
Use it to find employee records based on relevant workplace. Possible URL formats: www.example-company.com https://www.example-company.com . Any other formats will return no results, even though your query will be shown as successful (200 response code). |
Example input:
Example output:
Filter name | Data input type | Description |
|---|---|---|
experience_company_professional_network_url | String | Profile of current or previous workplace on Professional Network |
Usage |
|---|
Use to find employee records based on the relevant workplace. Note: only the Professional Network company profile URL or shorthand name is accepted. |
Example input:
Example output:
Filter name | Data input type | Description | Usage |
|---|---|---|---|
experience_company_industry | String | Workplace industry | Search based on the available list of industries. Available operators:
|
Use "(first phrase) OR (second phrase)" if you are searching for words in a phrase and want them to be interpreted together.
The list of company industries:
Filter name | Data input type | Description | Usage |
|---|---|---|---|
experience_company_size | String | Employee's workplace headcount (previous or current) | Find employee records based on the headcount of the current/previous workplace. Available operators:
|
Use "(size) OR (size)" if you are searching for words in a phrase and want them to be interpreted together.
Possible size input values:
Filter name | Data input type | Description |
|---|---|---|
experience_company_employees_count_gte | Integer | Headcount in the current or previous workplace |
Usage |
|---|
Find employee records based on the headcount in the current or previous workplace. The output value will be greater than or equal to the input value. |
Example input:
Example output:
Filter name | Data input type | Description |
|---|---|---|
experience_company_employees_count_lte | Integer | Headcount in the current or previous workplace |
Usage |
|---|
Find employee records based on the headcount in the current or previous workplace. The output value will be less than or equal to the input value. |
Example input:
Example output:
Filter name | Data input type | Description | Usage |
|---|---|---|---|
experience_date_from | String | Employment start date Appears if active_experience is TRUE. | Use it to find employee records based on employment start date/duration. Use the month yyyy or yyyy date format. The output value will be greater than or equal to the input value. |
If you prefer to see the date_fromfield as null in the profile data, use the value 1000 with the filter.
Alternatively, if you want the field to be!=nulland don't have a date requirement, use the value 1001 with the filter.
Example input:
Example output:
Filter name | Data input type | Description | Usage |
|---|---|---|---|
experience_date_to | String | Employment end date Appears if active_experience is TRUE. | Use it to find employee records based on employment end date/duration. Use the month yyyyor yyyydate format. The output value will be less than or equal to the input value. |
If you prefer to see the date_fromfield as null in the profile data, use the value 1000 with the filter.
Alternatively, if you want the field to be!=nulland don't have a date requirement, use the value 1001 with the filter.
Example input:
Example output:
Filter name | Data input type | Description | Usage |
|---|---|---|---|
experience_description | String | Keywords visible in the experience description | Use it to find employee records using relevant keywords. Available operators:
|
Example input:
Example output:
Filter name | Data input type | Description | Usage |
|---|---|---|---|
experience_deleted | Boolean | Marks record's public availability | Use it to see employee experience records that are deleted or private. Use the value true to include deleted/private records or false to exclude such records from your search. Tip: combine it with other experience filters to search for relevant records. |
Example input:
Example output:
Filter name | Data input type | Description | Usage |
|---|---|---|---|
experience_company_id | Integer | Company identification key | Use to find employee records based on possible workplaces. Use the acquired company IDs to match companies with employee profiles. |
Example input:
Example output:
Filter name | Data input type | Description | Usage |
|---|---|---|---|
active_experience | Boolean | Marks current employees | Use it to find the current employees. Note: only true value is usable with the filter. Tip: combine it with other experience filters to search for relevant records. |
Example input:
Example output:
Filter name | Data input type | Description | Usage |
|---|---|---|---|
keyword | String | Keywords in different profile sections. Fields included in search: summary; industry; skill; experience_title; experience_description | Use the find employee profiles that contain relevant keywords. Available operators:
|
Example input:
Use "(first phrase) OR (second phrase)" if you are searching for words in a phrase and want them to be interpreted together.
Example output:
Use "\"{keyword}\"" format to find exact matches.
Filter name | Data input type | Description |
|---|---|---|
education_institution_name | String | Education institution listed on the employee's profile. |
Usage |
|---|
Use to find employee records according to their education. Available operators:
|
Example input:
Use "(first phrase) OR (second phrase)" if you are searching for words in a phrase and want them to be interpreted together.
Example output:
Filter name | Data input type | Description |
|---|---|---|
education_institution_exact_name | String | The exact name of the education institution listed on the employee's profile. |
Usage |
|---|
Use to find employee records according to their education. Exact name = the institution name as it is written in the employee's profile. |
Example input:
Example output:
Filter name | Data input type | Description | Usage |
|---|---|---|---|
education_program_name | String | Study program the employee has/had enrolled in | Use it to find employee records based on study programs. The full program name is not required - the filter will match the records that include the required word or phrase (e.g., it). Available operators:
|
Example input:
Use "(first phrase) OR (second phrase)" if you are searching for words in a phrase and want them to be interpreted together.
Example output:
Use "\"{keyword}\"" format to find exact matches.
Filter name | Data input type | Description | Usage |
|---|---|---|---|
education_description | String | Education experience description | Use it to find employee records with relevant education. Available operators:
|
The keyword will be matched in the data.
For example, if you input pyyou will get results where pyis present in the education description but not Python.
Example input:
Example output:
Filter name | Data input type | Description | Usage |
|---|---|---|---|
education_date_from | String | Enrolment date | Use it to find employee records based on the education start date/duration. Use the month yyyy or yyyy date format. The output value will be greater than or equal to the input value. |
If you prefer to see the date_fromfield as null in the profile data, use the value 1000 with the filter.
Alternatively, if you want the field to be!=nulland don't have a date requirement, use the value 1001 with the filter.
Example input:
Example output:
Filter name | Data input type | Description | Usage |
|---|---|---|---|
education_date_to | String | Graduation date | Use it to find employee records based on the education end date/duration. Use the month yyyy or yyyy date format. The output value will be less than or equal to the input value. |
If you prefer to see the date_fromfield as null in the profile data, use the value 1000 with the filter.
Alternatively, if you want the field to be!=nulland don't have a date requirement, use the value 1001 with the filter.
Example input:
Example output:
Filter name | Data input type | Description | Example |
|---|---|---|---|
education_institution_professional_network_url | String | School's profile on Professional Network | Use it to find employee records according to their education. |
Example input:
Example output: