Sign in
People Enrichment

People Search

Canonical V3 people lookup with all company, title, role, people, channel, and contact-detail filters.

post/v3/people/search

Request body

company_domainstring
company_namestring
linkedin_urlstring

B2B company profile URL or slug.

company_filtersobject

Criteria-based company set. Supports the full Company Search filter family.

people_filtersobject

People-level filters for names, title/function/level, geography, profile URLs, headline/about-me/industry, languages, seniority, connection count, and channel availability. Canonical keys use the contact_* prefix (e.g. contact_linkedin_about_me); bare aliases such as about_me, headline, industry, and city are accepted. Keys the search cannot honor are echoed in interpreted_search.ignored_people_filters rather than silently dropped.

titlestring
job_titlestring
titlesstring[]
rolesstring[]
querystring

Free-text people/title query.

required_emailboolean

Only return people with email availability.

required_mobileboolean

Only return people with mobile availability.

channelsstring[]

Legacy alias for contactability requirements.

channel_match'any' | 'all'
include_companyboolean
include_domain_intelboolean
include_contact_detailsboolean

Opt in to paid raw email/mobile fields (alias — full_search). Bills 1 extra credit per returned email and 5 per returned mobile; base results are 1 credit per returned person.

include_emailboolean
include_mobileboolean
confirm_credit_chargeboolean
previewboolean
limitinteger
offsetinteger

Example request

{
  "company_domain": "leadmagic.io",
  "company_name": "LeadMagic",
  "linkedin_url": "https://www.linkedin.com/company/leadmagichq/",
  "title": "VP Sales",
  "job_title": "Head of Revenue"
}

Response

People search results

messagestring
credits_consumednumber
credit_previewobject
companiesobject[]
countinteger
returned_countinteger
limit_appliedinteger
offsetinteger
metadataobject

Changes