Skip to main content
POST
Search people
10 Credits Describe the people you need by role, employer, location, skills, or experience. Each request returns up to 10 people with their profile links, current role, employer, location, experience, skills, and schools; unavailable details are null or empty lists.
Country and experience filters apply in addition to your query, and every result must match both.

Pagination

Pass next_cursor back as cursor with the same query and filters to fetch the next page.
Stop when next_cursor is null or absent; a full page does not guarantee another page. There is no limit parameter, and cursors cannot be reused with a different query or filters.

Credits

Each nonempty page costs 10 credits, and searches with no matches are free. Try it in the API playground.

Authorizations

Authorization
string
header
required

Send Authorization: Bearer <API_KEY>. Keys have full access unless restricted to scopes.

Body

application/json
query
string
required

Describe the people to find.

Required string length: 1 - 500
Example:

"VPs of sales at solar companies in California"

filters
object

Additional constraints every result must match.

cursor
string

Use next_cursor with the same query and filters to fetch the next page.

Maximum string length: 65536
tags
string[]

Labels for filtering usage in the dashboard.

Maximum array length: 20
Required string length: 1 - 50
Example:

Response

Successful response

results
object[]
required

Up to 10 matching people, most relevant first.

Maximum array length: 10
request_id
string<uuid>
required

Unique ID of this request, also in X-Request-Id. Include it when contacting support.

Example:

"3f1c2a6e-8b4d-4c1e-9f0a-2d7b5e6c8a91"

next_cursor
string | null

Pass as cursor to fetch the next page; null when there are no more results.

key_metadata
object

Credits this request used and your remaining balance.