# Search Filters: Base Employee API {% columns %} {% column width="16.666666666666664%" %} Data type: Query type: URL: {% endcolumn %} {% column %} Base Employee Coresignal's custom filters {% endcolumn %} {% endcolumns %} *** ## Overview 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 `/v2/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. ## Endpoint structure {% code title="Full structure" %} ```json { "full_name": "string", "headline": "string", "location": "string", "industry": "string", "summary": "string", "created_at_gte": "string", "created_at_lte": "string", "updated_at_gte": "string", "updated_at_lte": "string", "deleted": true, "country": "string", "inferred_skills": "string", "certification_title": "string", "experience_title": "string", "experience_company_name": "string", "experience_company_exact_name": "string", "experience_company_website_url": "string", "experience_company_website_exact_url": "string", "experience_company_professional_network_url": "string", "experience_company_industry": "string", "experience_company_size": "string", "experience_company_employees_count_gte": 0, "experience_company_employees_count_lte": 0, "experience_date_from": "string", "experience_date_to": "string", "experience_description": "string", "experience_deleted": true, "experience_company_id": 0, "active_experience": true, "keyword": "string", "education_institution_name": "string", "education_institution_exact_name": "string", "education_program_name": "string", "education_description": "string", "education_date_from": "string", "education_date_to": "string", "education_institution_professional_network_url": "string" } ``` {% endcode %} ## Filter list
full_name | 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:** {% code title="name" %} ```json { "name": "John" } ``` {% endcode %} {% code title="surname" %} ```json { "name": "Doe" } ``` {% endcode %} {% code title="full name" %} ```json { "full_name": "John Doe" } ``` {% endcode %} **Example output with corresponding fields in the output data:** {% code title="name" %} ```json "first_name": "John", ``` {% endcode %}
headline | 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:** {% code title="No operator" %} ```json { "headline": "data analyst" } ``` {% endcode %} {% code title="Operator OR" %} ```json { "headline": "(data analyst) OR (data scientist)" } ``` {% endcode %} {% code title="Operator AND" %} ```json { "headline": "data analyst AND data scientist" } ``` {% endcode %} {% hint style="success" %} Use `"(first phrase) OR (second phrase)"` if you are searching for words in a phrase and want them to be interpreted together. {% endhint %} **Example output:** {% code title="Example" %} ```json "full_name": "John Doe", "headline": "Data Analyst" ``` {% endcode %} *** {% hint style="info" %} Use `"\"{keyword}\""` format to find exact matches. {% endhint %} {% code title="Exact match" %} ```json { "headline": "\"product manager\"" } ``` {% endcode %}
location | 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:** {% code title="location" %} ```json { "location": "New York" } ``` {% endcode %} **Example output:** {% code title="Example" %} ```json "full_name": "John Doe", "location": "New York", "industry": "Technology", ``` {% endcode %}
industry | 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:

| {% hint style="success" %} Use `"(first phrase) OR (second phrase)"` if you are searching for words in a phrase and want them to be interpreted together. {% endhint %} {% code title="Phrases" %} ```json { "industry": "(Information technology) OR Internet" } ``` {% endcode %} Possible input values can be found in general [Search filters](https://docs.coresignal.com/api-introduction/requests/search-filters#possible-input-values) topic.
summary | 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:

| {% hint style="success" %} You can use the operator `*` to finish the keyword. For example, `"py"` will return results with *py v*isible in them. `Py*` will return results with the completed word, e.g., Python. {% endhint %} **Example input:** {% code title="No operator" %} ```json { "summary": "Python" } ``` {% endcode %} {% code title="Operator OR" %} ```json { "summary": "(Software development) OR SQL" } ``` {% endcode %} {% code title="Operator AND" %} ```json { "summary": "Python AND SQL" } ``` {% endcode %} {% hint style="success" %} Use `"(first phrase) OR (second phrase)"` if you are searching for words in a phrase and want them to be interpreted together. {% endhint %} **Example output:** {% code title="Example" overflow="wrap" %} ```json "summary": "Engineering Team Leader for Test Team working on the Controllers for Example Corp." ``` {% endcode %}
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 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:** {% code title="created\_at" %} ```json { "created_at_gte": "2025-01-26 12:00:00" } ``` {% endcode %} **Example output:** {% code title="Example" %} ```json "last_response_code": 404, "created": "2025-01-26 12:00:00", "last_updated": "2025-03-24 11:00:00", ``` {% endcode %}
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 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:** {% code title="created\_at" %} ```json { "created_at_lte": "2025-01-26 12:41:10" } ``` {% endcode %} **Example output:** {% code title="Example" %} ```json "last_response_code": 404, "created": "2025-02-22 14:00:00", "last_updated": "2025-04-12 01:00:00", ``` {% endcode %}
updated_at_gte | 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:** {% code title="last\_updated\_gte" %} ```json { "updated_at_gte": "2025-02-26 12:00:00" } ``` {% endcode %} **Example output:** {% code title="Example" %} ```json "last_updated": "2025-03-21 17:00:00", "last_response_code": 200, ``` {% endcode %}
updated_at_lte | 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:** {% code title="updated\_at\_lte" %} ```json { "updated_at_lte": "2025-02-26 12:00:00" } ``` {% endcode %} **Example output:** {% code title="Example" %} ```json "last_updated": "2025-01-09 05:00:00", "last_response_code": 200, ``` {% endcode %}
deleted | 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:** {% code title="true" %} ```json { "deleted": true } ``` {% endcode %} {% code title="false" %} ```json { "experience_deleted": false } ``` {% endcode %} **Example output:** {% code title="Deleted profile" %} ```json { "id": 963, "name": "John Doe", "first_name": "John", "last_name": "Doe", "title": "Partner at Example Company", "url": "https://www.proffesional_network.com/in/123456abc", "hash": "a10baabd001d10a0011cb01cabcda1a0", "location": "Greater Milwaukee Area", "industry": "Law Practice", "summary": "I specialize in commercial real estate and finance transactions.", "connections": "20", "recommendations_count": null, "logo_url": null, "last_response_code": 404, "created": "2016-07-01 14:00:00", "last_updated": "2023-09-01 08:00:00", "outdated": 0, "deleted": 1, "country": "United States", ``` {% endcode %}
country | 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:

| {% hint style="success" %} Use `"(first phrase) OR (second phrase)"` if you are searching for words in a phrase and want them to be interpreted together. {% endhint %} {% code title="country" %} ```json { "country": "(United Kingdom) OR Germany" } ``` {% endcode %} Possible input values can be found in general [Search filters](https://docs.coresignal.com/api-introduction/requests/search-filters#possible-input-values) topic.
inferred_skills | Filter name | Data input type | Description | Usage | | ----------------- | --------------- | ------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `inferred_skills` | String | Lists employees' skills based on the descriptions from the profile |

Use it to find employee records based on relevant skills.
Available operators:

| {% hint style="success" %} You can use a part of the keyword with the operator `*`. In this case, you will see words that start with `py`. {% endhint %} **Example input:** {% code title="No operator" %} ```json { "inferred_skills": "python" } ``` {% endcode %} {% code title="OR operator" %} ```json { "inferred_skills": "(microsoft excel) OR (data processing)" } ``` {% endcode %} {% code title="AND operator" %} ```json { "inferred_skills": "python OR SQL" } ``` {% endcode %} {% hint style="success" %} Use `"(first phrase) OR (second phrase)"` if you are searching for words in a phrase and want them to be interpreted together. {% endhint %} **Example output:** {% code title="Example output" %} ```json "member_skills_collection": [ { "id": 111, "member_id": 2222, "skill_id": 333, "created": "2023-07-22 14:00:00", "last_updated": "2023-10-01 13:00:00", "deleted": 1, "member_skill_list": { "id": 444, "skill": "python", "hash": "23eeeb4347bdd26bfc6b7ee9a3b755dd", "created": "2023-08-22 14:00:00", "last_updated": "2023-09-22 14:00:00" } } ] ``` {% endcode %} *** {% hint style="info" %} Use `"\"{keyword}\""` format to find exact matches. {% endhint %} {% code title="Exact match" %} ```json { "inferred_skills": "\"microsoft excel\" OR SQL" } ``` {% endcode %}
certification_title | 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:

| {% hint style="success" %} You can use a part of the keyword with the operator `*`. In this case, you will see words that start with `py` as, the certification name. {% endhint %} **Example input:** {% code title="No operator" %} ```json { "certification_title": "Data processing" } ``` {% endcode %} {% code title="AND operator" %} ```json { "certification_title": "Data processing AND Python" } ``` {% endcode %} {% code title="OR operator" %} ```json { "certification_title": "(Data processing) OR (Python development)" } ``` {% endcode %} {% hint style="success" %} Use `"(first phrase) OR (second phrase)"` if you are searching for words in a phrase and want them to be interpreted together. {% endhint %} **Example output:** {% code title="Example" %} ```json "member_certifications_collection": [ { "id": 123, "member_id": 456, "name": "Certified Data Specialist", "authority": "License 1123456-987", "url": "https://www.example.com/certificate/1123456-987/data-processing-specialist", "date_from": "September 2024", "date_to": null, "created": "2024-09-01 14:00:00", "last_updated": "2024-09-19 00:00:00", "deleted": 1 } ] ``` {% endcode %} *** {% hint style="info" %} Use `"\"{keyword}\""` format to find exact matches. {% endhint %} {% code title="Exact match" %} ```json { "certification_title": "\"Data processing\"" } ``` {% endcode %}
experience_title | 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:

| {% hint style="success" %} 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. {% endhint %} **Example input:** {% code title="No operator" %} ```json { "experience_title": "project manager" } ``` {% endcode %} {% code title="OR operator" %} ```json { "experience_title": "(project manager) OR sales" } ``` {% endcode %} {% code title="AND operator" %} ```json { "experience_title": "project manager AND sales" } ``` {% endcode %} {% hint style="success" %} Use `"(first phrase) OR (second phrase)"` if you are searching for words in a phrase and want them to be interpreted together. {% endhint %} **Example output:** {% code title="Example" %} ```json "member_experience_collection": [ { "id": 1000, "member_id": 1001, "title": "Front Office Executive", "location": null, "company_name": "Example Company", "company_url": "https://www.professional_network.com/company/example-company", "date_from": "March 2020", "date_to": "July 2020", "duration": "5 months", "description": "

As an admin posts.......

", "created": "2020-07-01 14:00:00", "last_updated": "2020-11-01 20:00:00", "deleted": 1, "order_in_profile": null, "company_id": 3000001 } ] ``` {% endcode %} *** {% hint style="info" %} Use `"\"{keyword}\""` format to find exact matches. {% endhint %} {% code title="Exact match" %} ```json { "experience_title": "\"project manager\"" } ``` {% endcode %}
experience_company_name | 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:

| {% hint style="success" %} 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. {% endhint %} **Example input:** {% code title="experience\_company\_name" %} ```json { "experience_company_name": "example" } ``` {% endcode %} {% code title="AND operator" %} ```json { "experience_company_name": "(example1) AND (example2)" } ``` {% endcode %} {% code title="OR operator" %} ```json { "experience_company_name": "(example1) OR (example2)" } ``` {% endcode %} {% hint style="success" %} Use `"(first_company) OR/AND (second_company)"` when including several company names in the query. {% endhint %} **Example output:** {% code title="Example" %} ```json "member_experience_collection": [ { "id": 1000, "member_id": 1001, "title": "Front Office Executive", "location": null, "company_name": "Example Company", "company_url": "https://www.professional_network.com/company/example-company", "date_from": "March 2020", "date_to": "July 2020", "duration": "5 months", "description": "

As an admin posts.......

", "created": "2020-07-01 14:00:00", "last_updated": "2020-11-01 20:00:00", "deleted": 1, "order_in_profile": null, "company_id": 3000001 } ] ``` {% endcode %}
experience_company_exact_name | Filter name | Data input type | Description | Usage | | ------------------------------- | --------------- | ----------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `experience_company_exact_name` | String | Exact name of the current or previous workplace |

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

| {% hint style="success" %} 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. {% endhint %} {% code title="experience\_company\_exact\_name" %} ```json { "experience_company_exact_name": "Example" } ``` {% endcode %} **Example output:** {% code title="Example" %} ```json "member_experience_collection": [ { "id": 1000, "member_id": 1001, "title": "Front Office Executive", "location": null, "company_name": "Example Company", "company_url": "https://www.professional_network.com/company/example-company", "date_from": "March 2020", "date_to": "July 2020", "duration": "5 months", "description": "

As an admin posts.......

", "created": "2020-07-01 14:00:00", "last_updated": "2020-11-01 20:00:00", "deleted": 1, "order_in_profile": null, "company_id": 3000001 } ] ``` {% endcode %}
experience_company_website_url | Filter name | Data input type | Description | Usage | | -------------------------------- | --------------- | -------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `experience_company_website_url` | String | Website of the current or previous workplace |

Use it to find employee records based on the relevant workplace.
Possible URL formats:

[www.example.com](http://www.example.com)

.

| **Example input:** {% code title="https" %} ```json { "experience_company_website_url": "https://www.example.com" } ``` {% endcode %} {% code title="www" %} ```json { "experience_company_website_url": "www.example.com" } ``` {% endcode %} **Example output:** {% code title="Example" %} ```json "member_experience_collection": [ { "id": 1000, "member_id": 1001, "title": "Front Office Executive", "location": null, "company_name": "Example Company", "company_url": "https://www.professional_network.com/company/example-company", "date_from": "March 2020", "date_to": "July 2020", "duration": "5 months", "description": "

As an admin posts.......

", "created": "2020-07-01 14:00:00", "last_updated": "2020-11-01 20:00:00", "deleted": 1, "order_in_profile": null, "company_id": 3000001 } ] ``` {% endcode %}
experience_company_website_exact_url | Filter name | Data input type | Description | Usage | | -------------------------------------- | --------------- | ------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `experience_company_website_exact_url` | String | The exact website of the current or previous workplace |

Use it to find employee records based on the relevant workplace.
Possible URL formats:

[www.example.com](http://www.example.com)

.

| **Example input:** {% code title="experience\_company\_website\_exact\_url" %} ```json { "experience_company_website_exact_url": "https://www.example.com" } ``` {% endcode %} **Example output:** {% code title="Example" %} ```json "member_experience_collection": [ { "id": 1000, "member_id": 1001, "title": "Front Office Executive", "location": null, "company_name": "Example Company", "company_url": "https://www.professional_network.com/company/example-company", "date_from": "March 2020", "date_to": "July 2020", "duration": "5 months", "description": "

As an admin posts.......

", "created": "2020-07-01 14:00:00", "last_updated": "2020-11-01 20:00:00", "deleted": 1, "order_in_profile": null, "company_id": 3000001 } ] ``` {% endcode %}
experience_company_professional_network_url | Filter name | Data input type | Description | Usage | | --------------------------------------------- | --------------- | ----------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `experience_company_professional_network_url` | String | Professional network profile of the current or previous workplace |

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:** {% code title="URL" %} ```json { "experience_company_professional_network_url": "https://www.professional_network.com/company/example-company" } ``` {% endcode %} {% code title="Shorthand name" %} ```json { "experience_company_professional_network_url": "example-company" } ``` {% endcode %} **Example output**: {% code title="Example" %} ```json "member_experience_collection": [ { "id": 123456789, "member_id": 987654321, "title": "Waitress", "location": "NY, USA", "company_name": "Example Comapny", "company_url": "https://www.professional_network.com/company/example-company", "date_from": "September 2019", "date_to": "November 2019", "duration": "3 months", "description": "

Receiving phone call, know food allergies, serve customer, and working independently during the busy hours.

", "created": "2019-11-01 11:00:00", "last_updated": "2020-06-01 00:00:00", "deleted": 1, "order_in_profile": null, "company_id": 01234567 } ] ``` {% endcode %}
experience_company_industry | Filter name | Data input type | Description | Usage | | ----------------------------- | --------------- | ------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `experience_company_industry` | String | Workplace industry |

Search based on the available list of industries.
Available operators:

| {% hint style="success" %} Use `"(first phrase) OR (second phrase)"` if you are searching for words in a phrase and want them to be interpreted together. {% endhint %} Possible input values for `industry` can be found in general [Search filters](https://docs.coresignal.com/api-introduction/requests/search-filters#possible-input-values) topic.
experience_company_size | 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:

| {% hint style="success" %} Use `"(size) OR (size)"` if you are searching for words in a phrase and want them to be interpreted together. {% endhint %} {% code title="OR operator" %} ```json { "experience_company_size": "(11-50 employees) OR (1 employee)" } ``` {% endcode %} Possible input values for `size` can be found in general [Search filters](https://docs.coresignal.com/api-introduction/requests/search-filters#possible-input-values) topic.
experience_company_employees_count_gte | Filter name | Data input type | Description | Usage | | ---------------------------------------- | --------------- | --------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `experience_company_employees_count_gte` | Integer | Workplace's headcount |

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:** {% code title="experience\_company\_employees\_count\_gte" %} ```json { "experience_company_employees_count_gte": 100 } ``` {% endcode %} **Example output:** {% code title="Member experience" %} ```json "member_experience_collection": [ { "id": 1000, "member_id": 1001, "title": "Front Office Executive", "location": null, "company_name": "Example Company", "company_url": "https://www.professional_network.com/company/example-company", "date_from": "March 2020", "date_to": "July 2020", "duration": "5 months", "description": "

As an admin posts.......

", "created": "2020-07-01 14:00:00", "last_updated": "2020-11-01 20:00:00", "deleted": 1, "order_in_profile": null, "company_id": 3000001 } ] ``` {% endcode %}
experience_company_employees_count_lte | Filter name | Data input type | Description | Usage | | ---------------------------------------- | --------------- | --------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `experience_company_employees_count_lte` | Integer | Workplace's headcount |

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:** {% code title="experience\_company\_employees\_count\_lte" %} ```json { "experience_company_employees_count_lte": 200 } ``` {% endcode %} **Example output:** {% code title="Member experience" %} ```json "member_experience_collection": [ { "id": 1000, "member_id": 1001, "title": "Front Office Executive", "location": null, "company_name": "Example Company", "company_url": "https://www.professional_network.com/company/example-company", "date_from": "March 2020", "date_to": "July 2020", "duration": "5 months", "description": "

As an admin posts.......

", "created": "2020-07-01 14:00:00", "last_updated": "2020-11-01 20:00:00", "deleted": 1, "order_in_profile": null, "company_id": 3000001 } ] ``` {% endcode %}
experience_date_from | 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.

| {% hint style="success" %} 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. {% endhint %} **Example input:** {% code title="date format: yyyy" %} ```json { "experience_date_from": "2018" } ``` {% endcode %} {% code title="date format: month yyyy" %} ```json { "experience_date_from": "January 2018" } ``` {% endcode %} **Example output:** {% code title="Example" %} ```json "member_experience_collection": [ { "id": 100, "member_id": 200, "title": "Commercial Manager", "location": null, "company_name": "Example Company", "company_url": "https://www.professional_network.com/company/example-company", "date_from": "2018", "date_to": "2021", "duration": "3 years", "description": null, "created": "2018-07-01 14:00:00", "last_updated": "2018-06-01 00:00:00", "deleted": 1, "order_in_profile": null, "company_id": 2222222 } ] ``` {% endcode %}
experience_date_to | 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 yyyy or yyyydate format.
The output value will be less than or equal to the input value.

| {% hint style="success" %} 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. {% endhint %} **Example input:** {% code title="date format: yyyy" %} ```json { "experience_date_to": "2021" } ``` {% endcode %} {% code title="date format: month yyyy" %} ```json { "experience_date_from": "January 2021" } ``` {% endcode %} **Example output:** {% code title="Example" %} ```json "member_experience_collection": [ { "id": 987654, "member_id": 20, "title": "Technical support Associate", "location": null, "company_name": "Example Company", "company_url": "https://www.professional_network.com/company/example-company", "date_from": "February 2019", "date_to": "July 2020", "duration": "1 year 6 months", "description": "

I worked @ Example Company as Technical solution associate for a period of 18 Months.

", "created": "2019-06-01 08:00:00", "last_updated": "2019-07-01 08:00:00", "deleted": 1, "order_in_profile": null, "company_id": 7035141 } ] ``` {% endcode %}
experience_description | 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:** {% code title="No operator" %} ```json { "experience_description": "python" } ``` {% endcode %} {% code title="OR operator" %} ```json { "experience_description": "python OR SQL" } ``` {% endcode %} {% code title="AND operator" %} ```json { "experience_description": "python AND SQL" } ``` {% endcode %} **Example output:** {% code title="Example" %} ```json "member_experience_collection": [ { "id": 624862486, "member_id": 624, "title": "Computational Scientist", "location": "CA, USA", "company_name": "Example Company", "company_url": "https://www.professional_network.com/company/example-company", "date_from": "September 2021", "date_to": null, "duration": null, "description": "Computational scientist in the Computational Science group in Data Analytics at Example Company.\n\Currently favorite tools: Microsoft Power Platforms, Python and R", "created": "2021-10-06 06:37:18", "last_updated": "2022-11-21 13:03:52", "deleted": 0, "order_in_profile": 1, "company_id": 3020104 } ] ``` {% endcode %}
experience_deleted | 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:** {% code title="true" %} ```json { "experience_deleted": true } ``` {% endcode %} {% code title="false" %} ```json { "experience_deleted": false } ``` {% endcode %} **Example output:** {% code title="Example" %} ```json "member_experience_collection": [ { "id": 147, "member_id": 147258, "title": "Technical expert", "location": null, "company_name": "Example Company", "company_url": "https://www.professional_network.com/company/example-company", "date_from": null, "date_to": null, "duration": null, "description": null, "created": "2019-07-01 14:00:00", "last_updated": "2022-05-01 16:00:00", "deleted": 1, "order_in_profile": null, "company_id": 10203040 } ] ``` {% endcode %}
experience_company_id | 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:** {% code title="experience\_company\_id" %} ```json { "experience_company_id": 456 } ``` {% endcode %} **Example output:** {% code title="Example" %} ```json "member_experience_collection": [ { "id": 654321987, "member_id": 45601230, "title": "Network Engineer", "location": "Greater New York City Area", "company_name": "Example Consulting", "company_url": "https://www.professional_network.com/company/example-consulting", "date_from": "June 2018", "date_to": "July 2023", "duration": "5 years 2 months", "description": null, "created": "2018-06-27 01:00:00", "last_updated": "2023-07-09 12:00:00", "deleted": 0, "order_in_profile": 3, "company_id": 147258 } ] ``` {% endcode %}
active_experience | 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:** {% code title="active\_experience" %} ```json { "active_experience": true } ``` {% endcode %} **Example output:** {% code title="Example" %} ```json "member_experience_collection": [ { "id": 1234567890, "member_id": 123, "title": "Senior Software Engineer", "location": "NY, USA", "company_name": "Example", "company_url": "https://www.professional_network.com/company/example-company", "date_from": "August 2022", "date_to": null, "duration": null, "description": null, "created": "2022-09-01 12:00:00", "last_updated": "2023-05-01 07:00:00", "deleted": 0, "order_in_profile": 1, "company_id": 987654 } ] ``` {% endcode %}
keyword | 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:** {% code title="No operator" %} ```json { "keyword": "python" } ``` {% endcode %} {% code title="OR operator" %} ```json { "keyword": "python OR (software development)" } ``` {% endcode %} {% code title="AND operator" %} ```json { "keyword": "python AND SQL" } ``` {% endcode %} {% hint style="success" %} Use `"(first phrase) OR (second phrase)"` if you are searching for words in a phrase and want them to be interpreted together. {% endhint %} **Example output:** {% code title="Summary" overflow="wrap" %} ```json "summary": "Engineering Team Leader for Test Team working on the Engine Controllers for Example Corp." ``` {% endcode %} *** {% hint style="info" %} Use `"\"{keyword}\""` format to find exact matches. {% endhint %} {% code title="Exact match" %} ```json { "keyword": "\"python\"" } ``` {% endcode %}
education_institution_name | Filter name | Data input type | Description | Usage | | ---------------------------- | --------------- | ------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `education_institution_name` | String | Education institution listed on the employee's profile. |

Use to find employee records according to their education.
Available operators:

| **Example input:** {% code title="education\_institution\_name" %} ```json { "education_institution_name": "it*" } ``` {% endcode %} {% code title="OR operator" %} ```json { "education_institution_name": "example1 OR (example2 university)" } ``` {% endcode %} {% code title="AND operator" %} ```json { "education_institution_name": "example1 AND example2 university" } ``` {% endcode %} {% hint style="success" %} Use `"(first phrase) OR (second phrase)"` if you are searching for words in a phrase and want them to be interpreted together. {% endhint %} **Example output:** {% code title="Example" %} ```json "member_education_collection": [ { "id": 101, "member_id": 1001, "title": "Example University", "subtitle": "Bachelor of Technology", "date_from": "2019", "date_to": "2023", "activities_and_societies": null, "description": null, "created": "2019-08-22 14:00:00", "last_updated": "2023-12-12 09:00:00", "deleted": 0, "school_url": null } ], ``` {% endcode %}
education_institution_exact_name | Filter name | Data input type | Description | Usage | | ---------------------------------- | --------------- | ---------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------- | | `education_institution_exact_name` | String | The exact name of the education institution listed on the employee's profile | Use to find employee records according to their education. `Exact name` = the institution name listed on the employee's profile. | **Example input:** {% code title="education\_instution\_exact\_name" %} ```json { "education_institution_exact_name": "Example University" } ``` {% endcode %} **Example output:** {% code title="Example" %} ```json "member_education_collection": [ { "id": 123456789, "member_id": 98765, "title": "Example University", "subtitle": "Innovation Program", "date_from": "2024", "date_to": "2024", "activities_and_societies": null, "description": null, "created": "2024-03-01 15:00:00", "last_updated": "2024-10-01 22:00:00", "deleted": 1, "school_url": null } ] ``` {% endcode %}
education_program_name | 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:** {% code title="education\_program\_name" %} ```json { "education_program_name": "it" } ``` {% endcode %} {% code title="OR operator" %} ```json { "education_program_name": "(applied sciences) OR (computer science)" } ``` {% endcode %} {% code title="AND operator" %} ```json { "education_program_name": "applied sciences AND computer science" } ``` {% endcode %} {% hint style="success" %} Use `"(first phrase) OR (second phrase)"` if you are searching for words in a phrase and want them to be interpreted together. {% endhint %} **Example output:** {% code title="Example " %} ```json "member_education_collection": [ { "id": 100, "member_id": 12345, "title": "Example University", "subtitle": "Bachelor's Degree, IT, Distinction", "date_from": "2017", "date_to": "2023", "activities_and_societies": null, "description": null, "created": "2017-09-01 14:00:00", "last_updated": "2023-08-01 03:00:00", "deleted": 1, "school_url": null } ] ``` {% endcode %} *** {% hint style="info" %} Use `"\"{keyword}\""` format to find exact matches. {% endhint %} {% code title="Exact match" %} ```json { "keyword": "\"applied sciences\"" } ``` {% endcode %}
education_description | Filter name | Data input type | Description | Usage | | ----------------------- | --------------- | -------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `education_description` | String | Education experience description |

Use it to find employee records with relevant education.
Available operators:

| {% hint style="success" %} 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`. {% endhint %} **Example input:** {% code title="No operator" %} ```json { "education_description": "python" } ``` {% endcode %} {% code title="AND operator" %} ```json { "education_description": "python AND SQL" } ``` {% endcode %} {% code title="OR operator" %} ```json { "education_description": "python OR (software engineering)" } ``` {% endcode %} **Example output:** {% code title="Example" %} ```json "member_education_collection": [ { "id": 123456789, "member_id": 987654, "title": "Portfolio Management", "subtitle": "Trading", "date_from": "2023", "date_to": null, "activities_and_societies": "

\n Activities and Societies: Traded personal portfolio using a mixture of ETF, Futures and Options with positions gaining 128%+ Adj Gain and 13%+ on overall portfolio.\n

", "description": "

\n Income, Options and Commodities spaces with functional design based on structuring trades, systemic risk and executing positions according to valuations based on quantitative models in Excel & Python\n

", "created": "2023-11-01 23:00:00", "last_updated": "2024-10-01 04:00:00", "deleted": 1, "school_url": null } ] ``` {% endcode %}
education_date_from | 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.

| {% hint style="info" %} 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. {% endhint %} **Example input:** {% code title="format: yyyy" %} ```json { "education_date_from": "2018" } ``` {% endcode %} {% code title="format: month yyyy" %} ```json { "education_date_from": "January 2018" } ``` {% endcode %} **Example output:** {% code title="Example" %} ```json "member_education_collection": [ { "id": 10, "member_id": 123, "title": "Example english school", "subtitle": "Exciting knowledge in Electronics", "date_from": "2018", "date_to": "2022", "activities_and_societies": null, "description": null, "created": "2018-09-01 14:00:00", "last_updated": "2022-09-09 16:00:00", "deleted": 1, "school_url": null } ] ``` {% endcode %}
education_date_to | 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.

| {% hint style="success" %} 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. {% endhint %} **Example input:** {% code title="date format: yyyy" %} ```json { "education_date_to": "2022" } ``` {% endcode %} {% code title="date format: month yyyy" %} ```json { "education_date_to": "January 2022" } ``` {% endcode %} **Example output:** {% code title="Example" %} ```json "member_education_collection": [ { "id": 10, "member_id": 123, "title": "Example english school", "subtitle": "Exciting knowledge in Electronics", "date_from": "2018", "date_to": "2022", "activities_and_societies": null, "description": null, "created": "2018-09-01 14:00:00", "last_updated": "2022-09-09 16:00:00", "deleted": 1, "school_url": null } ] ``` {% endcode %}
education_institution_professional_network_url | 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:** {% code title="education\_institution\_professional\_network\_url" overflow="wrap" %} ```json { "education_institution_professional_network_url": "https://www.professional_network.com/school/example-university/" } ``` {% endcode %} **Example output:** {% code title="Example" %} ```json "member_education_collection": [ { "id": 123123123, "member_id": 010101, "title": "Example University", "subtitle": "Workshop in Leadership", "date_from": "2024", "date_to": null, "activities_and_societies": null, "description": null, "created": "2024-09-01 12:00:00", "last_updated": "2024-09-24 23:00:00", "deleted": 1, "school_url": "https://www.professional_network.com/school/example-university/" } ] ``` {% endcode %}
## Sample request {% code title="Request example" expandable="true" %} ```json curl -X 'POST' \ 'https://api.coresignal.com/cdapi/v2/employee_base/search/filter' \ -H 'accept: application/json' \ -H 'apikey: {API Key}' \ -H 'Content-Type: application/json' \ -d '{ "headline": "CSO", "location": "United States", "industry": "Information Technology" }' ``` {% endcode %} --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.coresignal.com/employee-api/base-employee-api/endpoints/search-filters.md?ask= ``` The question should be specific, self-contained, and written in natural language. 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.