Skip to main content
POST
Search people

Authorizations

Authorization
string
header
required

API Token used for authentication. Example: "Authorization: Bearer {token}"

Body

application/json
pageSize
integer<int32>

The maximum number of people to return

Required range: 1 <= x <= 100
cursor
string | null

An opaque cursor returned by a previous search response. Omit for the first page.

Maximum string length: 1024
expand
enum<string>[] | null

Additional person data to include, charged on top of the base cost. Repeating an expansion does not multiply its cost:

  • education: 1 credit per returned person.
  • company: 1 credit per unique company successfully expanded across the returned current and past experiences. Includes the standard company profile; separately priced company expansions are not included. Unavailable companies retain their summary without an expansion charge. Search charges each company once per response page. Limited to 500 unique available companies per request; exceeding the limit returns 400 without charging credits. Reduce pageSize for searches or remove company from expand.
Available options:
education,
company
filter
object | null

The filters to apply to the people search

semantic
object | null

The natural-language query used to infer person filters and the current companies

company
object | null

The company query used to find people whose current companies match

Response

OK

items
object[]
required

The people returned for this page

nextCursor
string | null

An opaque cursor for the next page. Omitted when there are no more results.

interpretation
object | null

How the semantic query was interpreted. Present for semantic queries.