Skip to main content
Deep Search takes a description of the people or companies you want and finds matching profiles. Use it when you can say who you need but not which fields and values to filter on. When you know the exact conditions, Filter Search is more precise.

Write the query

Name what a matching profile has in common: role, company or industry, location, seniority.

Request

Response

Returns a Job. A finished search identifies the saved search and its results file:
HTTP 200
A search that is not finished within wait_seconds returns HTTP 202 with status: "running" and no result. Poll GET /v1/jobs/{job_id} until it finishes. See Run a search end to end. Read profiles from Search Results.

Parameters

Send exactly one of query, filters, seeds or search_id.
string
People or companies to find, in your own words.
object
Exact, range or Boolean conditions. See Filter Search.
array
From 1 to 1,000 example people. See Lookalike Search. People only.
string
Saved search to run again.
integer
default:10
Maximum results. Minimum 1, up to the max_results returned by GET /v1/people/search/fields or GET /v1/companies/search/fields.
string[]
Saved lists to leave out. Limit: 5 by default, up to 10 with a higher organization limit.
integer
default:5
Seconds to wait for the Job to finish, from 0 to 20.
string
HTTPS callback URL. See Outgoing Webhooks.

Discover fields

GET /v1/people/search/fields and GET /v1/companies/search/fields return supported fields and query limits. Use the matching POST /v1/people/search/field-values or POST /v1/companies/search/field-values with {"field":"industry","max_results":10} to discover values.

Try it

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