Search people

Early access. Tell us what you're building and we'll set you up. Contact us

POSTapi.lempile.com/people/search

Searches active, provenance-approved people snapshots. Platform admins may set sample: true to search synthetic admin sample records. This route requires people.read.

Authentication

X-API-KEY header·A Lempile API key, made in the dashboard under Access tokens.

Request body

person_countriesarray of string
person_locationsarray of string
job_titlesarray of string
senioritiesarray of string
company_domainsarray of string
company_employee_rangesarray of EmployeeRange
›Show fieldsHide fields
- mininteger
  ≥ 0
- maxinteger
  ≥ 0
company_industriesarray of string
email_statusesarray of string
has_emailboolean
facetsarray of string
pageinteger
Default1≥ 1 · ≤ 500
per_pageinteger
Default25≥ 1 · ≤ 100
sampleboolean
Platform-admin-only synthetic sample mode.

Responses

200

People search result.

›

application/json

objectanyrequired
Alwayspeople_search_result
totalintegerrequired
pageintegerrequired
per_pageintegerrequired
has_morebooleanrequired
dataarray of PeopleSearchRecordrequired
›Show fieldsHide fields
- objectany
  Alwaysperson_search_record
- idstring
- person_namestring
- first_namestring | null
- last_namestring | null
- titlestring | null
- title_normalizedstring | null
- function_primarystring | null
- senioritystring | null
- linkedin_urlstring | null
- locationobject
- companyobject
- contactobject
  ›Show fieldsHide fields
  email_availableboolean
  email_statusstring | null
  email_confidencenumber | null
  phone_availableboolean
  phone_statusstring | null
- sourceobject
facetsobjectrequired

400

Invalid request body, filters, facets, or pagination.

›

application/json

errorstringrequired
messagestringrequired

401

Missing or invalid API key.

›

application/json

errorstringrequired
messagestringrequired

403

API key lacks people.read, or sample mode was requested by a non-admin key.

›

application/json

errorstringrequired
messagestringrequired

Was this page helpful?