Skip to main content
POST
Run salesnavigator-search-company-employees action live
1 credit per result · credit_ratio 1 · Credit costs Sales Navigator people search 950 / 24 h · Action limits

Agent skill

edges-salesnavigator-search-company-employees — ready-made instructions for coding agents calling this endpoint.
LinkedIn paces this action separately. Roughly 500 companies every 2 hours when you ask for up to 25 employees each. Raising max_results per company lowers the number of companies proportionally — asking for 250 employees each brings it down to about 2 companies every 2 hours.
To run LinkedIn actions, you must first create an identity and connect a LinkedIn account, either using our Chrome Extension, username/password login, or Managed Accounts to run without connecting an account.
Prefer X-Pagination-Next and X-Pagination-Previous over constructing pagination URLs yourself. Stop only when X-Pagination-Next is absent — a short page (fewer results than the previous page, or than the action’s usual page size) does not mean you are done. LinkedIn’s page length can vary from one request to the next; the result array length is not a stop condition.

Inputs

  • sales_navigator_company_url or linkedin_company_id— Identifies the company whose employees you want to search.
  • sales_navigator_profile_search_url(optional) is a Sales Navigator people search URL (https://www.linkedin.com/sales/search/people...) to reuse an existing search. When provided, the action applies the filters (and optionally keywords) from that URL to the company’s employees.
When you pass sales_navigator_profile_search_url:
  1. The action force the current_company filter in the request with the company id.
  2. It merges the query= from your people search URL with the base query.
  3. Keywords from the people search are kept or added if not already in the base query.
When to use sales_navigator_profile_search_url: If you provide this URL, the action relies mainly on the filters from that URL. Use it to reuse a saved or existing people search and apply it to the company’s employees.

Notes

  • Maximum results : up to 2,500 results.
  • Various filters are supported, including exclusion fields (e.g. function_excluded, geography_excluded, current_job_title_excluded) and exclusion booleans (exclude_saved_leads, exclude_viewed_leads, etc.). See the API schema for the full list.

Authorizations

X-API-Key
string
header
required

Query Parameters

cursor
string

Cursor value obtained from the X-Pagination-Next response header of a previous request, used to continue pagination. Cursors expire after 24 hours. If a cursor has expired or is invalid, pagination must be restarted from the beginning.

page_size
integer
default:25

Maximum number of results per page (read-only; defined by the endpoint, actual count may be lower in some cases like throttling or internal limits).

Required range: 25 <= x <= 25

Body

application/json
input
object
required
parameters
object
identity_ids
string<uuid>[] | null

An array of Identity UUIDs linked to identities (e.g. LinkedIn) used to execute the Action. You must provide at least one valid UID with access to the integration. Do not use account_uid values — only user_uid is supported.

Example:
identity_mode
enum<string> | null
default:direct

If "auto", the Action will use any identities from the current workspace (unless you have provided a list of identity_ids). "managed" will use the Edges pool of identities for an extra credit cost

Available options:
direct,
auto,
managed

Response

Successful response

full_name
string
first_name
string
last_name
string
company_name
string
sales_navigator_company_id
string
linkedin_profile_id
integer
connection_degree
integer
job_title
string
summary
string
profile_image_url
string<uri>
sales_navigator_search_url
string<uri>
sales_navigator_profile_url
string<uri>
linkedin_profile_url
string<uri>
sales_navigator_profile_id
string
sales_navigator_company_url
string<uri>
location
string
position_started_at
string
linkedin_people_post_search_url
string<uri>
viewed
boolean
tenure_start
string
tenure_end
string
tenure_length
string
recently_hired
boolean
recently_promoted
boolean
current_company
string