Skip to main content
Find the buyer’s decision makers, not businesses like the seller. List-capable filters match any value; different filters combine with AND. For qualified target accounts, search companies first with company_search and pass their domains or IDs here.
Preview is a free, unpaginated sample of up to 10, without contact details or exact totals. Its full_search field suggests the call that starts full records, after you authorize the spend. Full records keep every stored field; next_page suggests the next full page, or is null when there are no more. Follow-up calls are never automatic. Empty results are free. A contact detail on file doesn’t prove it’s deliverable or that the person intends to buy.

Targeting

boolean
Free unpaginated sample of up to 10, no contact details or exact totals. Ignores limit. has_more may be true without a cursor; use full_search only after authorization.
string | string[]
Title text.
string | string[]
c_suite, vp, director, head, manager, founder, owner, partner, senior or entry (matched on the title).
string | string[]
Job function.
string | string[]
Part of the industry, e.g. "software".
string | string[]
Company size, from 1-10 up to 10001+.
string | string[]
Person location, not company HQ: ISO 3166-1 alpha-2 codes, e.g. ["GB", "IE"].
string | string[]
Exact city names.
string | string[]
People at these companies, e.g. your target accounts.
boolean
Only people with that contact detail on file.
string | string[]
Skills, e.g. "salesforce".
string
Plain words; each must appear in the name, email, title, company, industry or location.
string[]
Leave out existing customers or people already contacted. Preview accepts at most 10 excluded company domains and rejects person-ID exclusions; use a full search for larger domain lists or excluded person IDs.

Enrichment

string | string[]
Look up or enrich known people; pass a list to enrich many at once.
string | string[]
Part of the name; add company_domain. Lists are independent, not paired name-company lookups, so enrich specific pairs separately.

Paging

integer
default:"20"
Full-page size, 1–100. Preview ignores this and samples up to 10. Returns one page; fetch more only when requested.
string
Full results only: use next_page.arguments unchanged, preserving filters, exclusions and limit. Restart without a cursor when targeting changes. Preview can’t paginate.

Full-record output

person_id, first_name, middle_name, last_name, full_name, email, alternate_email, email_type, phone, alternate_phone.
job_title, seniority, role, industry, skills, interests, years_experience.
address, city, region, zip_code, country, country_code, continent, countries.
linkedin_url, linkedin_connections, x_url, instagram_url, tiktok_url, facebook_url, github_url.
gender, age, birth_year, birth_month, birth_date, estimated_income, income_min, income_max.
object
Nested employer: company_id, name, domain, industry, employee_size_band, size_min, size_max, website, phone, address, country, country_code, linkedin_url, x_url, facebook_url. For the employer’s own extras and updated_at, run company_search by company_id.
Custom imported fields as a string-valued map, plus the record update timestamp. Output fields aren’t automatically searchable filters. Empty strings, null numbers or company, and empty arrays or maps mean not on file.
Responses over 8 MiB are rejected without partial records, and a full search may already have charged credits for them. Retry with fewer records or narrower filters rather than repeating the same call.