Search

Search Company Employees

Description

Retrieve employee records from companies based on specified filtering criteria including role, seniority, department, location, and date ranges.

triangle-exclamation

Endpoint

POST api/v1/realtime/social/workforce/v1/company-employees/search

Parameters

Param
Required
Param Type
Description

company_linkedin_identifiers

No

Body Param

List | List of strings Specifies LinkedIn company identifiers to filter by. The array must contain at least one string if provided

seniorities

No

Body Param

List | Specifies the seniority levels to filter by. The array must contain at least one string if provided. Options: owner, founder, c suite, partner, vp, head, director, manager, Senior, Entry, Intern

departments

No

Body Param

List | Specifies the departments to filter by. The array must contain at least one string if provided. Options: Design, Education, Engineering, Finance, Healthcare, Human Resources, IT, Executive Leadership, Legal, Marketing & Communications, Operations, Product, Sales & Business Development, Consulting

industries

No

Body Param

List | Specifies the company industries to filter by. The array must contain at least one string if provided. Options: Information Technology & Services, Construction, Marketing & Advertising, Real Estate, Health, Wellness & Fitness, Management Consulting, Computer Software, Internet, Retail, Financial Services, Consumer Services, Hospital & Health Care, Automotive, Restaurants, Education Management, Food & Beverages, Design, Hospitality, Accounting, Events Services

role

No

Body Param

String | Specifies roles to filter by. for example "marketing"

Object | Specifies roles to filter by boolean logic:

AND Condition - All terms must be present:

OR Condition - Any term can be present:

NOT IN Condition - Excludes specific terms:

Combined Conditions - Nested boolean logic:

negative_role

No

Body Param

String | Excludes a specific role from the results.

location_country

No

Body Param

String | Filters results by the specified country.

role_start_date_before

No

Body Param

String | Filters results to include only roles that started before the specified date (ISO 8601 date)

role_start_date_after

No

Body Param

String | Filters results to include only roles that started after the specified date (ISO 8601 date)

page

No (default 1)

Body Param

Number | Specifies the page number of the results to retrieve [1-10]

page_size

No (default 1000)

Body Param

Number | Specifies the number of results per page [1-1000]

chevron-rightExample Requesthashtag
chevron-rightExample Responsehashtag

Response Description

Root Fields

  • items (array of objects): A list of employees and their details.

  • total_count (string): The total number of items matching the query.

  • page (integer): The current page number of the response.

  • page_size (integer): The number of items per page.

Item Fields

Each item in the items array contains the following fields:

  • company_linkedin_identifier (string): The LinkedIn identifier of the company.

  • employee_linkedin_identifier (string): The LinkedIn identifier of the employee.

  • full_name (string): The full name of the employee.

  • role (string): The role or position of the employee.

  • departments (array of strings): The departments associated with the employee.

  • seniority (string): The seniority level of the employee.

  • role_start_date (string or null): The start date of the role in ISO 8601 format. Null if not available.


Last updated