LinkedIn People Search

Overview

Find people on LinkedIn by job title, company, location, industry and company size. Combine filters freely — at least one of them is required. Each person comes back in the same shape as linkedin_person_profile (name, headline, location, current job and career entries). The result is paged: next_cursor in the response is repeated back as cursor for the next page, null means the end.

When to use

Build lead lists like "Heads of Sales at German software companies with 51-200 employees".
Narrow a target group by seniority (job_levels), department (job_functions) or employer size (company_sizes).
Page through a large result set; each page is billed separately for the people it returns.

[!NOTE] When 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

Each person's experiences list contains the career entry that matched the filters (usually just one), not the full career. Call linkedin_person_profile with a person's linkedin_url for the complete profile.

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`	No filter was given or a field is malformed (an unknown `job_levels`, `job_functions` or `company_sizes` value, a bad country code, a non-company LinkedIn URL).	Fix the request payload and retry.
`not_found`	The search completed but 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.