Built-in tool
Find Leads
Find new people to prospect at any company, such as leads, contacts and sales leaders like VPs or Heads of Sales, then strictly check each current title before saving the confirmed matches to a list; a shortfall comes back in counts per reason with what to change.
Endpoint
Parameters
| Name | Type | Required | Note |
|---|---|---|---|
| modestring · optional | string | optional | Preview lists matching people without importing them; import adds them to your workspace. One of: |
| limitnumber · optional | number | optional | Number of people to import, up to 200. A preview shows up to 20 of them and prices the full number. Default: |
| citiesobject · optional | object | optional | Cities or regions where the people are based. |
| listIdstring · optional | string | optional | Existing People list to import the people into. Choose only one destination. |
| listNamestring · optional | string | optional | Name of a new or existing People list to import the people into. Choose only one destination. |
| countriesobject · optional | object | optional | Countries where the people are based, by name or two-letter code. |
| findEmailboolean · optional | boolean | optional | Looks up work email and reports hits, failures and separate contact-enrichment credits used. This direct provider path reports 0 credits. Default: |
| findPhoneboolean · optional | boolean | optional | Looks up phone numbers and reports hits, failures and separate contact-enrichment credits used. This direct provider path reports 0 credits. Default: |
| investorsobject · optional | object | optional | Lead investors in the current company, by name. |
| jobTitlesobject · optional | object | optional | Current job titles to match, such as CTO, VP of Sales or Founder. |
| saveToCrmboolean · optional | boolean | optional | Imports the people straight into the People object, skipping LinkedIn profiles already there and linking their companies. Choose only one destination. |
| industriesobject · optional | object | optional | Industries of each person's current company, by LinkedIn industry name. |
| saveSearchboolean · optional | boolean | optional | Saves the confirmed People List import’s search and continuation for later replenishment. |
| hqCountriesobject · optional | object | optional | Countries where the current companies are headquartered; use this instead of person location for requests about US or other country-based companies. |
| listColumnsobject · optional | object | optional | Field names the person asked to display on a new List, in that order. |
| newFlowNamestring · optional | string | optional | Name of the new workflow that receives the people when no other destination is chosen. |
| companySizesobject · optional | object | optional | Employee-count ranges of each person's current company, such as 11-50 or 201-500. |
| flowNameOrIdstring · optional | string | optional | Existing workflow, by name or ID, to add the people to. Choose only one destination. |
| jobFunctionsobject · optional | object | optional | Departments to include, such as sales, engineering or marketing. |
| companiesListobject · optional | object | optional | Companies to find people at, by name, website domain or LinkedIn company URL. |
| excludeListIdsobject · optional | object | optional | Lists whose members should be excluded when existing-profile exclusion is on. |
| companyKeywordsobject · optional | object | optional | Keywords matched against each person's current company profile. |
| excludeExistingboolean · optional | boolean | optional | Skips people whose LinkedIn identity already exists in the destination Object or selected comparison lists. |
| lastFundingTypeobject · optional | object | optional | Types of the current company's most recent funding round to include, such as Seed or Series A. |
| seniorityLevelsobject · optional | object | optional | Seniority levels to include, such as CXO, Vice President, Director or Senior. |
| totalFundingMaxnumber · optional | number | optional | Maximum total funding raised by the current company, in US dollars. |
| totalFundingMinnumber · optional | number | optional | Minimum total funding raised by the current company, in US dollars. |
| confirmationTokenstring · optional | string | optional | Token from the preview with the same filters, passed back unchanged to confirm an import from an AI app. It expires after 30 minutes. |
| lastFundingYearMaxnumber · optional | number | optional | Latest year of the current company's most recent funding round. |
| lastFundingYearMinnumber · optional | number | optional | Earliest year of the current company's most recent funding round. |
| confirmedCreditCostnumber · optional | number | optional | Credit cost of the import as shown in the preview. Needed when the import costs credits. |
| userConfirmedImportboolean · optional | boolean | optional | Confirms that you approved the filters, destination, number of people and credit cost shown in the preview. |
| lastFundingAmountMaxnumber · optional | number | optional | Maximum size of the current company's most recent funding round, in US dollars. |
| lastFundingAmountMinnumber · optional | number | optional | Minimum size of the current company's most recent funding round, in US dollars. |
| lastFundingTypeExcludeobject · optional | object | optional | Types of the current company's most recent funding round to leave out. |