Built-in tool
Find People at Company
Find one or several decision-makers at one company from your ordered list of job titles (such as founder, CEO or head of sales), using AI research across LinkedIn and the web.
4 creditsNo API key neededEndpoint
Parameters
| Name | Type | Required | Note |
|---|---|---|---|
| companyDomainstring · required | string | required | The company to find people at. Example: |
| companyLinkedinUrlstring · optional | string | optional | Optional. When set, the node reads the company's LinkedIn employee list first and researches only the titles it cannot fill from there. Leave empty to research from the domain alone. A URL that turns out not to match this company is ignored and the run falls back to domain-only research. Example: |
| companyNamestring · optional | string | optional | Optional. Helps disambiguate search results when the domain alone is ambiguous. Example: |
| jobTitlesarray · required | array | required | One title per row, most important first. Order is the priority order: it decides which title a person is filed under when they match more than one, and which titles get searched first if a run is up against its research budget. Matched loosely — "Head of Ecommerce" also matches "Ecommerce Lead" or "Director of Ecommerce". Up to 30. Example: |
| limitnumber · optional | number | optional | Maximum people in Priority mode (default 10, up to 100). All matches uses the research ceiling of 100 instead. Default: Example: |
| jobTitlesExcludearray · optional | array | optional | Exclude these titles and equivalent roles. For L&D-only work exclude Machine Learning and AI Research. |
| searchModestring · optional | string | optional | Priority uses Limit. All matches researches beyond one person per title, up to 100 per company within the research budget. It cannot guarantee a complete employee census. One of: Default: |
| existingRecordModestring · optional | string | optional | Keep existing preserves existing People across the whole Object and adds only new People to the destination List. It does not change Object settings. One of: Default: |
Response schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"elements",
"total",
"totalElements",
"promptUsed",
"fellBackToWebResearch",
"employeeSearchesUsed",
"webSearchesUsed",
"budgetExhausted",
"limit",
"totalBeforeLimit",
"truncatedByLimit",
"searchMode",
"researchLimitReached",
"excludedPeopleCount",
"unmatchedJobTitles"
],
"properties": {
"meta": {
"type": "object",
"properties": {
"actualCreditCost": {
"type": "number"
},
"modelUsageCredits": {
"type": "number"
}
},
"additionalProperties": false
},
"limit": {
"type": "number"
},
"total": {
"type": "number"
},
"elements": {
"type": "array",
"items": {
"type": "object",
"required": [
"first_name",
"last_name",
"linkedin_profile_url",
"job_title"
],
"properties": {
"job_title": {
"type": "string"
},
"last_name": {
"type": "string"
},
"first_name": {
"type": "string"
},
"linkedin_profile_url": {
"type": "string"
}
},
"additionalProperties": false
}
},
"promptUsed": {
"enum": [
"A",
"B"
],
"type": "string"
},
"searchMode": {
"enum": [
"priority",
"all_matches"
],
"type": "string"
},
"totalElements": {
"type": "number"
},
"budgetExhausted": {
"type": "boolean"
},
"webSearchesUsed": {
"type": "number"
},
"totalBeforeLimit": {
"type": "number"
},
"truncatedByLimit": {
"type": "boolean"
},
"unmatchedJobTitles": {
"type": "array",
"items": {
"type": "string"
}
},
"excludedPeopleCount": {
"type": "integer",
"minimum": 0
},
"employeeSearchesUsed": {
"type": "number"
},
"researchLimitReached": {
"type": "boolean",
"description": "The 100-person research ceiling was reached; further matching people may exist."
},
"fellBackToWebResearch": {
"type": "boolean"
}
},
"additionalProperties": false
}
