Skip to main content
POST
Search People Database
To know which filters you are able to use, refer to the GET Filters section.Filters of type slider (such as currentCompanyFounded) take one or more min|max ranges in in: two numbers joined by |, such as 2015|2024. Their out must stay empty. An out value, or a range in another format such as 2015-2024, answers 400 Parameter filters is invalid. To exclude a range, send the ranges around it in in. For example, ["1900|1989", "2001|2026"] excludes the companies founded from 1990 to 2000.

Authorizations

Authorization
string
header
required

Basic authentication header of the form Basic <encoded-value>, where <encoded-value> is the base64-encoded string username:password.

Body

application/json

Search criteria. Provide one or more filters and optionally control pagination with page/size

filters
object[]

Array of filters (required, unless fromSearchId is provided). With fromSearchId, each filter replaces the saved filter with the same filterId and the other saved filters are kept; an empty or absent filters replays the search as is.

fromSearchId
string

Id of a previous People search of your team (not a Companies search): the search value returned by POST /database/people (optional). The search is replayed with its saved filters. Each filter you pass in filters replaces the saved filter with the same filterId, the other saved filters are kept, and the merged filters are validated again as for a new search. With fromSearchId, filters is optional: an empty or absent filters replays the search as is.

A search id can be replayed for 6 months. A replay counts as one search in the daily search quota (see limitation in the response); only a paid part triggered elsewhere, such as LinkedIn post engagement, is not billed again.

If no search matches this id for your team and this mode, or the search is older than 6 months, the request is rejected with 404.

Pattern: ^lsh_[a-zA-Z0-9]{17}$
Example:

"lsh_ExAmPlEuJiOYFFPTI"

page
integer

Page (optional)

Required range: x >= 1
size
integer

Size of the results, number between 1 and 100 (optional)

Required range: 1 <= x <= 100
excludes
string[]

Array of properties to exclude from the results (optional)

Free-text query across common people fields (e.g., name, title, company, location)

Response

Success

results
object[]

Results array

total
integer

Total number of results

took
integer

Duration of the elastic-search query in milliseconds

page
integer

Current page number

size
integer

Size of the results (asked through parameters)

Unique identifier of the current search. Reuse it as fromSearchId on POST /database/people to replay this search; it stays valid for 6 months.

limitation
integer

Remaining calls for the POST People database and POST Companies database (search is limited to a number of queries every 24 hours)

team
string

Unique identifier of the current team