Persons

Search persons with their emails and phones

Covers professional contacts only: people in their role at a company, not private individuals. Returns only people with an email or phone, with full contact data, and charges 1 credit per returned person. Page with nextOffset. limit 0 returns only totalCount, free. saveToContacts also stores them in your contacts, where people you already had are refunded. Send an Idempotency-Key header to make retries safe.

post/persons/search

Request

  • Base URL: https://www.deeplead.io/api/v1
  • URL: https://www.deeplead.io/api/v1/persons/search
  • Auth: HTTP bearer

Request body

querystring

Free text matched against company name, description and keywords

semanticstring

What the company is and sells, matched by meaning, e.g. "outsourced medical billing for clinics"

domainsstring[]

Look companies up by domain, e.g. ["stripe.com"]

hqCountrystring[]

ISO alpha-2 country codes of the headquarters, e.g. ["US", "DE"]

hqStatestring[]

US state names or codes of the headquarters

employeeBandsstring[]

Headcount bands

revenueRangestring[]

Annual company revenue bands

industryNaicsDirectstring[]

NAICS codes

technologiesstring[]

Technologies used by the company

foundedAfterinteger

Earliest founding year to include

foundedBeforeinteger

Latest founding year to include

monthlyVisitsMininteger

Minimum monthly website visits; known for about 1 in 8 US companies, the rest are excluded

employeeGrowthMininteger

Minimum employee growth on LinkedIn in percent, e.g. 10; known for about 1 in 13 US companies

fundedAfterinteger

Year of the last funding round, at least; known for about 1 in 100 US companies

jobTitlestring[]

Matched as partial text, so "CEO" also finds "Assistant to the CEO"; combine with jobLevel to narrow

jobTitleExcludestring[]

Job title phrases to exclude

jobLevelstring[]

Allowed job seniority levels

decisionMakersOnlyboolean

C-level, VP or director seniority, or a founder, owner, CEO, managing director or president title

inCountrystring[]

ISO alpha-2 country codes where the person is based

personStatestring[]

States where the person is based

personCitystring[]

Cities where the person is based

organizationIdsstring[]

Limit to organizations from /organizations/search

limitinteger

Maximum people to return; 0 returns only a free count

offsetinteger

Pagination offset; use nextOffset from the previous response

onePerOrganizationboolean

Return at most one person per company

saveToContactsboolean

Save returned people to your Deeplead contacts

Response

OK

totalCountnumber required

With limit 0: all matching people, including those without an email or phone

nextOffsetnumber nullable required
chargedCreditsnumber required

Changes

No recorded changes to this operation across all 1 revision of this API.