Skip to main content
Use POST /v1/people/search for people and POST /v1/companies/search for companies. Send exactly one of query, filters, seeds or search_id; companies do not accept seeds. Every search returns a Job. Use Search Results to read its items, page through them and export them.

Run a search end to end

A Deep Search or Lookalike Search can take a few minutes, so the first response is often a Job that is still running. A Filter Search usually finishes within the wait window. The steps are the same for every kind of search:
  1. Start the search. The response is a Job with a job_id.
  2. Poll GET /v1/jobs/{job_id} until status is succeeded, failed or canceled.
  3. Read the profiles from GET /v1/jobs/{job_id}/items, following next_cursor until it is null.
  4. To get a file, export the Job.
This example finds up to 25 people and prints each name and LinkedIn URL. cURL also requires jq.
A failed Job carries the reason in error. See Handling Errors.

Try it

Open the Search People API Reference playground.
For the original routes, see Legacy Search.