Skip to main content
Find people at companies based on their role, title, or department. Use this to identify decision makers for outreach. 
const people = await canvas.people.search({
  companies,
  titles: ["CTO", "VP Engineering"],
  seniorities: ["c-suite", "vp"],
  maxPerCompany: 3,
});

​
Parameters

​
companies
Company[]
required
Companies to search within. Usually the output of canvas.companies.find().
​
titles
string[]
Job titles to search for (e.g., ["CTO", "VP Engineering"]).
​
seniorities
FiberSeniority[]
required
Required. Seniority levels (e.g., ["c-suite", "vp", "director"]). Valid values: senior, staff, principal, lead, manager, head, director, vp, svp, c-suite.
​
departments
string[]
Departments to search in (e.g., ["engineering", "sales", "marketing"]).
​
maxPerCompany
number
default:"5"
Maximum number of people to find per company.
​
_providers
string[]
Advanced: Override the provider waterfall order. Options: apollo, pdl, sonar_pro, sonar_deep_research, gpt_5, gemini, o4_mini_deep_research
At least one of titles or departments is required.

​
Returns

Array of people matching the criteria. Each person includes:
FieldTypeDescription
namestringFull name
titlestringJob title
companystringCompany name
domainstringCompany domain
linkedin_urlstringLinkedIn profile URL (if available)

​
Examples

​
Find C-Suite Executives

const executives = await canvas.people.search({
  companies,
  titles: ["CEO", "CFO", "CTO", "COO"],
  seniorities: ["c-suite"],
  maxPerCompany: 2,
});

​
Find Sales Leaders

const salesLeaders = await canvas.people.search({
  companies,
  titles: ["VP Sales", "Head of Sales", "Sales Director"],
  seniorities: ["vp", "director", "head"],
  departments: ["sales"],
  maxPerCompany: 1,
});

​
Find Engineering Leads

const engineers = await canvas.people.search({
  companies,
  departments: ["engineering"],
  seniorities: ["director", "vp", "head"],
  maxPerCompany: 3,
});