Contact usLog inStart free

Search Filters

Data type:

Query type:

URL:

Base Employee

Coresignal's custom filters

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

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

Full structure
{
  "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",
  "skill": "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", 
  "is_hidden": true
}

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:

name
{
  "name": "John"
}
surname
{
  "name": "Doe"
}
full name
{
  "full_name": "John Doe"
}

Example output with corresponding fields in the output data:

name
"first_name": "John",
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:

  • AND (both keywords need to be present)

  • OR (one of the two input values)

Example input:

No operator
{
  "headline": "data analyst"
}
Operator OR
{
  "headline": "(data analyst) OR (data scientist)"
}
Operator AND
{
  "headline": "data analyst AND data scientist"
}

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

Example output:

Example
"full_name": "John Doe",
"headline": "Data Analyst"

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

Exact match
{
  "headline":  "\"product manager\""
}
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:

location
{
  "location": "New York"
}

Example output:

Example
 "full_name": "John Doe",
 "location": "New York",
 "industry": "Technology",
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:

  • 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
{
  "industry": "(Information technology) OR Internet"
}

Possible input values can be found in general Search filters 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:

  • AND (both keywords need to be present)

  • OR (one of the two input values)

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:

No operator
{
  "summary": "Python"
}
Operator OR
{
  "summary": "(Software development) OR SQL"
}
Operator AND
{
  "summary": "Python AND SQL"
}

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

Example output:

Example
"summary": "Engineering Team Leader for Test Team working on the Controllers for Example Corp."
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:

created_at
{
  "created_at_gte": "2025-01-26 12:00:00"
}

Example output:

Example
"last_response_code": 404,
"created": "2025-01-26 12:00:00",
"last_updated": "2025-03-24 11:00:00",

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:

created_at
{
  "created_at_lte": "2025-01-26 12:41:10"
}

Example output:

Example
"last_response_code": 404,
"created": "2025-02-22 14:00:00",
"last_updated": "2025-04-12 01:00:00",
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:

last_updated_gte
{
  "updated_at_gte": "2025-02-26 12:00:00"
}

Example output:

Example
"last_updated": "2025-03-21 17:00:00",
"last_response_code": 200,
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:

updated_at_lte
{
  "updated_at_lte": "2025-02-26 12:00:00"
}

Example output:

Example
"last_updated": "2025-01-09 05:00:00",
"last_response_code": 200,
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:

true
{
  "deleted": true
}
false
{
  "experience_deleted": false
}

Example output:

Deleted profile
{
    "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",
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:

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

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

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

skill
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:

  • AND (both keywords need to be present)

  • OR (one or the other keyword is present)

  • * (choose all profiles that have skill records)

You can use a part of the keyword with the operator *. In this case, you will see words that start with py.

Example input:

No operator
{
  "skill": "python"
}
OR operator
{
  "skill": "(microsoft excel) OR (data processing)"
}
AND operator
{
  "skill": "python OR SQL"
}

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

Example output:

Example output
"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"
                      }
                   }
                 ]

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

Exact match
{
  "skill": "\"microsoft excel\" OR SQL"
  }
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:

  • AND (both keywords need to be present)

  • OR (one or the other keyword is present)

  • * (choose all profiles that have certification records).

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.

Example input:

No operator
{
  "certification_title": "Data processing"
}
AND operator
{
  "certification_title": "Data processing AND Python"
}
OR operator
{
  "certification_title": "(Data processing) OR (Python development)"
}

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

Example output:

Example
 "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
        }
    ]

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

Exact match
{
  "certification_title":  "\"Data processing\""
}
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:

  • AND (both keywords need to be present)

  • OR (one or the other keyword is present)

  • * (choose all profiles that have experience records).

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:

No operator
{
  "experience_title": "project manager"
}
OR operator
{
  "experience_title": "(project manager) OR sales"
}
AND operator
{
  "experience_title": "project manager AND sales"
}

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

Example output:

Example
 "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": "<p class=\"description\" data-section=\"pastPositions\">As an admin posts.......</p>",
            "created": "2020-07-01 14:00:00",
            "last_updated": "2020-11-01 20:00:00",
            "deleted": 1,
            "order_in_profile": null,
            "company_id": 3000001
        }
  ]

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

Exact match
{
  "experience_title":  "\"project manager\""
}
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:

  • AND (both keywords need to be present)

  • OR (one or the other keyword is present)

  • * (choose all profiles with the company name in the experience record).

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:

experience_company_name
{
  "experience_company_name": "example"
}
AND operator
{
  "experience_company_name": "(example1) AND (example2)"
}
OR operator
{
  "experience_company_name": "(example1) OR (example2)"
}

Use "(first_company) OR/AND (second_company)" when including several company names in the query.

Example output:

Example
  "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": "<p class=\"description\" data-section=\"pastPositions\">As an admin posts.......</p>",
            "created": "2020-07-01 14:00:00",
            "last_updated": "2020-11-01 20:00:00",
            "deleted": 1,
            "order_in_profile": null,
            "company_id": 3000001
        }
  ]
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).

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.

experience_company_exact_name
{
  "experience_company_exact_name": "Example"
}

Example output:

Example
"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": "<p class=\"description\" data-section=\"pastPositions\">As an admin posts.......</p>",
            "created": "2020-07-01 14:00:00",
            "last_updated": "2020-11-01 20:00:00",
            "deleted": 1,
            "order_in_profile": null,
            "company_id": 3000001
        }
  ]
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

https://www.example.com.

Example input:

https
{
  "experience_company_website_url": "https://www.example.com"
}
www
{
  "experience_company_website_url": "www.example.com"
}

Example output:

Example
"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": "<p class=\"description\" data-section=\"pastPositions\">As an admin posts.......</p>",
            "created": "2020-07-01 14:00:00",
            "last_updated": "2020-11-01 20:00:00",
            "deleted": 1,
            "order_in_profile": null,
            "company_id": 3000001
        }
  ]
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

https://www.example.com .

Example input:

experience_company_website_exact_url
{
  "experience_company_website_exact_url": "https://www.example.com"
}

Example output:

Example
 "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": "<p class=\"description\" data-section=\"pastPositions\">As an admin posts.......</p>",
            "created": "2020-07-01 14:00:00",
            "last_updated": "2020-11-01 20:00:00",
            "deleted": 1,
            "order_in_profile": null,
            "company_id": 3000001
        }
  ]
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:

URL
{
  "experience_company_professional_network_url": "https://www.professional_network.com/company/example-company"
}
Shorthand name
{
  "experience_company_professional_network_url": "example-company"
}

Example output:

Example
"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": "<p class=\"description\" data-section=\"pastPositions\">Receiving phone call, know food allergies, serve customer, and working independently during the busy hours.</p>",
            "created": "2019-11-01 11:00:00",
            "last_updated": "2020-06-01 00:00:00",
            "deleted": 1,
            "order_in_profile": null,
            "company_id": 01234567
        }
  ]
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:

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

Possible input values for industry can be found in general Search filters 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:

  • OR (one or the other keyword is present in the data).

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

OR operator
{
  "experience_company_size": "(11-50 employees) OR (1 employee)"
}

Possible input values for size can be found in general Search filters 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:

experience_company_employees_count_gte
{
  "experience_company_employees_count_gte": 100
}

Example output:

Member experience
  "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": "<p class=\"description\" data-section=\"pastPositions\">As an admin posts.......</p>",
            "created": "2020-07-01 14:00:00",
            "last_updated": "2020-11-01 20:00:00",
            "deleted": 1,
            "order_in_profile": null,
            "company_id": 3000001
        }
  ]
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:

experience_company_employees_count_lte
{
  "experience_company_employees_count_lte": 200
}

Example output:

Member experience
  "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": "<p class=\"description\" data-section=\"pastPositions\">As an admin posts.......</p>",
            "created": "2020-07-01 14:00:00",
            "last_updated": "2020-11-01 20:00:00",
            "deleted": 1,
            "order_in_profile": null,
            "company_id": 3000001
        }
  ]
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.

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:

date format: yyyy
{
  "experience_date_from": "2018"
}
date format: month yyyy
{
  "experience_date_from": "January 2018"
}

Example output:

Example
"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
        }
  ]

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.

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:

date format: yyyy
{
  "experience_date_to": "2021"
}
date format: month yyyy
{
  "experience_date_from": "January 2021"
}

Example output:

Example
   "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": "<p class=\"position-body__description\" data-section=\"pastPositions\">I worked @ Example Company as Technical solution associate for a period of 18 Months.</p>",
            "created": "2019-06-01 08:00:00",
            "last_updated": "2019-07-01 08:00:00",
            "deleted": 1,
            "order_in_profile": null,
            "company_id": 7035141
        }
     ]

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:

  • AND (both keywords need to be present)

  • OR (one or the other keyword is present).

Example input:

No operator
{
  "experience_description": "python"
}
OR operator
 {
  "experience_description": "python OR SQL"
}
AND operator
{
  "experience_description": "python AND SQL"
}

Example output:

Example
"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
    }
]
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:

true
{
  "experience_deleted": true
}
false
{
  "experience_deleted": false
}

Example output:

Example
  "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
        }
    ]
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:

experience_company_id
{
  "experience_company_id": 456
}

Example output:

Example
"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
        }
  ]
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:

active_experience
{
  "active_experience": true
}

Example output:

Example
"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
        }
    ]

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:

  • AND (both keywords need to be present)

  • OR (one or the other keyword is present).

Example input:

No operator
{
  "keyword": "python"
}
OR operator
{
  "keyword": "python OR (software development)"
}
AND operator
{
  "keyword": "python AND SQL"
}

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

Example output:

Summary
 "summary": "Engineering Team Leader for Test Team working on the Engine Controllers for Example Corp."

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

Exact match
{
  "keyword":  "\"python\""
}
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:

  • AND (both keywords need to be present)

  • OR (one or the other keyword is present)

Example input:

education_institution_name
{
  "education_institution_name": "it*"
}
OR operator
{
  "education_institution_name": "example1 OR (example2 university)"
}
AND operator
{
  "education_institution_name": "example1 AND example2 university"
}

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

Example output:

Example
   "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
        }
    ],
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:

education_instution_exact_name
{
  "education_institution_exact_name": "Example University"
}

Example output:

Example
"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
        }
]
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:

  • AND (both keywords need to be present)

  • OR (one or the other keyword is present).

Example input:

education_program_name
{
  "education_program_name": "it"
}
OR operator
{
  "education_program_name": "(applied sciences) OR (computer science)"
}
AND operator
{
  "education_program_name": "applied sciences AND computer science"
}

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

Example output:

Example 
"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
        }
  ]

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

Exact match
{
  "keyword":  "\"applied sciences\""
}

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:

  • AND (both keywords need to be present)

  • OR (one or the other keyword is present).

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:

No operator
{
  "education_description": "python"
}
AND operator
{
  "education_description": "python AND SQL"
}
OR operator
{
  "education_description": "python OR (software engineering)"
}

Example output:

Example
"member_education_collection": [
        {
            "id": 123456789,
            "member_id": 987654,
            "title": "Portfolio Management",
            "subtitle": "Trading",
            "date_from": "2023",
            "date_to": null,
            "activities_and_societies": "<p class=\"education__item education__item--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              </p>",
            "description": "<p class=\"show-more-less-text__text--less\">\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 &amp; Python\n      </p>",
            "created": "2023-11-01 23:00:00",
            "last_updated": "2024-10-01 04:00:00",
            "deleted": 1,
            "school_url": null
        }
  ]
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.

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:

format: yyyy
{
  "education_date_from": "2018"
}
format: month yyyy
{
  "education_date_from": "January 2018"
}

Example output:

Example
"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
        }
    ]
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.

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:

date format: yyyy
{
  "education_date_to": "2022"
}
date format: month yyyy
{
  "education_date_to": "January 2022"
}

Example output:

Example
"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
        }
    ]
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:

education_institution_professional_network_url
{
  "education_institution_professional_network_url": "https://www.professional_network.com/school/example-university/"
}

Example output:

Example
"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/"
        }
  ]
is_hidden
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:

is_hidden
{
  "is_hidden": true
}

Example output:

Hidden status
 "member_hidden_status_collection": [
      {
        "id": 9404215,
        "member_id": 339537236,
        "is_hidden": 1,
        "created": "2024-01-27 23:24:22",
        "last_updated": "2024-02-05 14:47:50",
        "deleted": 0
      }
    ],
PreviousMapping EndpointNextPagination

Last updated

Was this helpful?