Search Filters
Data type: Base Employee Query type: Coresignal's custom filters URL: https://api.coresignal.com/cdapi/v1/professional_network/employee_base/search/filter
Explore the available filters, their potential applications, and helpful tips.
Use the endpoint to discover employee IDs. This endpoint offers a less complex user experience than the /v1/professional_network/employee_base/search/es_dsl endpoint.
If you prefer uncomplicated queries, opt for this endpoint. Below are details about filter explanations and how to use them.
Example outputs are redacted and may not contain all the fields you would receive using the endpoint.
See the list of possible error codes.
Filter name | Data input type | Description | Usage |
|---|---|---|---|
full_name | String | Employee's name | Use it to find records based on the employee's name, surname, or full name. |
Example input:
Example output with corresponding fields in the output data:
Filter name | Data input type | Description | Usage |
|---|---|---|---|
headline | String | Employee's job title (Employee's profile headline) | Use it to find 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 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. 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 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 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 |
|---|---|---|---|
updated_at_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 |
|---|---|---|---|
updated_at_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 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 | Country the employee is based in, 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 Note: Professional network has removed Skills from public profiles since April 2018 | 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_title | 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 py as 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 IT will 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., both Example and example will work for the filter). |
The filter returns an exact match with the input value. For example, if you input M as 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.com https://www.example.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 the relevant workplace. Possible URL formats: www.example.com https://www.example.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 | Professional network profile of the current or previous workplace |
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 | Workplace's 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 | Workplace's headcount |
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 | Workplace's headcount |
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_from field as null in the profile data, use the value 1000 with the filter.
Alternatively, if you want the field to be!=null and 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_to field as null in the profile data, use the value 1000 with the filter.
Alternatively, if you want the field to be !=null and 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 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 in our database | Use it to find employee records based on relevant 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 if the person is currently working | Use it to find 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 listed on the employee's profile. |
Example input:
Example output:
Filter name | Data input type | Description | Usage |
|---|---|---|---|
education_program_name | String | Study program the employee was 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 py you will get results where py is 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!=null and 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!=null and 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 Professional network profile URL | Use it to find employee records according to their education. |
Example input:
Example output:
Filter name | Data input type | Description | Usage |
|---|---|---|---|
is_hidden | Boolean | Marks if the employee profile has hidden sections (education/experience) | Use it to filter out employee profiles with hidden collections. |
Example input:
Example output: