nv_fetch_company
Extract company details from LinkedIn Sales Navigator, including employee and decision-maker information, using a hashed LinkedIn URL. Configure retrieval by specifying filters like job positions, locations, industries, and experience ranges.
Instructions
Allows you to open a company page in Sales Navigator to retrieve its basic information (nv.openCompanyPage action). Can optionally retrieve employees and decision makers.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| companyHashedUrl | Yes | Hashed LinkedIn URL of the company. | |
| dmRetrievalConfig | No | Optional. Configuration for retrieving decision makers. Available only if retrieveDMs is true. | |
| employeeRetrievalConfig | No | Optional. Configuration for retrieving employees. Available only if retrieveEmployees is true. | |
| retrieveDMs | No | Optional. Whether to retrieve the company's decision makers information. Default is false. | |
| retrieveEmployees | No | Optional. Whether to retrieve the company's employees information. Default is false. |
Input Schema (JSON Schema)
{
"properties": {
"companyHashedUrl": {
"description": "Hashed LinkedIn URL of the company.",
"type": "string"
},
"dmRetrievalConfig": {
"description": "Optional. Configuration for retrieving decision makers. Available only if retrieveDMs is true.",
"properties": {
"limit": {
"description": "Optional. Number of decision makers to retrieve. Defaults to 20, with a maximum value of 20. If a company has fewer decision makers than specified, only the available ones will be returned.",
"type": "number"
}
},
"type": "object"
},
"employeeRetrievalConfig": {
"description": "Optional. Configuration for retrieving employees. Available only if retrieveEmployees is true.",
"properties": {
"filter": {
"description": "Optional. Object that specifies filtering criteria for employees. When multiple filter fields are specified, they are combined using AND logic.",
"properties": {
"firstName": {
"description": "Optional. First name of employee.",
"type": "string"
},
"industries": {
"description": "Optional. Array of enums representing industries. Matches if employee works in any of the listed industries. Takes specific values available in the LinkedIn interface.",
"type": "array"
},
"lastName": {
"description": "Optional. Last name of employee.",
"type": "string"
},
"locations": {
"description": "Optional. Array of free-form strings representing locations. Matches if employee is located in any of the listed locations.",
"type": "array"
},
"positions": {
"description": "Optional. Array of job position names. Matches if employee's current position is any of the listed options.",
"type": "array"
},
"schools": {
"description": "Optional. Array of institution names. Matches if employee currently attends or previously attended any of the listed institutions.",
"type": "array"
},
"yearsOfExperiences": {
"description": "Optional. Array of enums representing professional experience. Matches if employee's experience falls within any of the listed ranges.",
"enum": [
"lessThanOne",
"oneToTwo",
"threeToFive",
"sixToTen",
"moreThanTen"
],
"type": "array"
}
},
"type": "object"
},
"limit": {
"description": "Optional. Maximum number of employees to retrieve. Defaults to 500, with a maximum value of 500.",
"type": "number"
}
},
"type": "object"
},
"retrieveDMs": {
"description": "Optional. Whether to retrieve the company's decision makers information. Default is false.",
"type": "boolean"
},
"retrieveEmployees": {
"description": "Optional. Whether to retrieve the company's employees information. Default is false.",
"type": "boolean"
}
},
"required": [
"companyHashedUrl"
],
"type": "object"
}