LinkedIn Company Employees

Overview

List the employees of a company by its website domain or its LinkedIn company page URL, optionally filtered by seniority (job_levels), department (job_functions) and country. A domain is first resolved to the company's LinkedIn page; company_linkedin_url is used directly and takes precedence when both are given. Each person comes back in the same shape as linkedin_person_profile. The result is paged by page (1-based) up to total_pages; each page is billed separately.

When to use

List decision makers of one account (e.g. Directors and VPs) for outbound.
Pull the engineering or sales team of a company for account mapping.
Page through a large employer; each page is billed separately for the people it returns.

[!NOTE] When the company has no LinkedIn page or nobody matches the filters the run completes successfully with found: false and is not charged — you only pay for people actually returned. Genuine errors of the data service (auth, rate limit, 5xx) still fail the run and are refunded.

Endpoint

Input

Output

This endpoint returns no email addresses or phone numbers. Use find_email_linkedin or find_phone_linkedin with a person's linkedin_url for contact data.

Pricing

This enrichment costs 1 credit per person returned, 0 credits without a hit. limit × that price is reserved up front (default 10, at most 50); only the people actually delivered are billed, the rest of the reservation is refunded.

Examples

Playground

States

State	Description
`queued`	Request accepted; waiting to be picked up by a worker.
`processing`	Worker is actively running the enrichment.
`completed`	Enrichment finished and results are available in `output`.
`failed`	Enrichment failed; reason is in `error`. Credits are refunded for failures unless otherwise noted.

Errors

Error	When it happens	What to do
`invalid_input`	Neither `company_domain` nor `company_linkedin_url` was given, or a field is malformed.	Fix the request payload and retry.
`not_found`	The lookup completed but the company has no LinkedIn page or nobody matched.	No action — the run costs nothing.
`rate_limited`	The data service throttled the request.	Retry with backoff.
`provider_error`	The data service returned an unexpected error.	Retry; if persistent, contact support.
`503 endpoint_unavailable`	The endpoint is currently not configured or temporarily disabled. Nothing is reserved or charged.	Retry later; if persistent, contact support.