Actions36
- Authentication Actions
- Profile Actions
- Company Actions
- Network Actions
- Message Actions
- Post Actions
- Recruiter Actions
- Data Actions
Overview
This node integrates with the Linkup API to perform advanced company data searches on LinkedIn. Specifically, the Search Companies operation under the Data resource allows users to query companies based on various criteria such as keywords, industry, location, employee range, and whether they are founding companies. This is useful for enriching datasets, lead generation, market research, or competitive analysis by retrieving detailed company information from LinkedIn's data.
Practical examples include:
- Finding startups in a specific industry and location.
- Filtering companies by size and sector for targeted marketing campaigns.
- Identifying founding companies within a geographic region.
Properties
| Name | Meaning |
|---|---|
| Keyword | Search keyword to find companies matching specific terms. |
| Industry | Business sector of the company (e.g., Technology, Finance). |
| Location | Geographic location of the company (city, state, country). |
| Employee Range | Size of the company by number of employees; options like "1-10", "11-50", "51-200", etc. |
| Founding Company | Boolean flag to filter only founding companies (true/false). |
| Total Results | Maximum number of company results to return (number). |
| Timeout (Advanced Option) | Request timeout in milliseconds (default 30000 ms). |
| Retry Count (Advanced Option) | Number of retries if the request fails (default 3). |
Output
The node outputs JSON data containing the search results returned by the Linkup API. The output includes:
- A
_debugobject with details about the request body, headers, endpoint URL, and raw API response for troubleshooting. - The main response data from the API, which typically contains an array of company records matching the search criteria.
- Metadata including the resource name ("data"), operation name ("searchCompaniesData"), timestamp of execution, and node version.
- Each output item is paired with its input item index for traceability.
No binary data output is produced by this operation.
Dependencies
- Requires an API key credential for authenticating with the Linkup API service.
- The node uses HTTP POST requests to the Linkup API endpoint
https://api.linkupapi.com/v1/data/search/companies. - Network connectivity to the Linkup API service is necessary.
- Optional configuration of request timeout and retry count can be set via node parameters.
Troubleshooting
- Missing API Key Error: If the API key credential is not configured or invalid, the node will throw an error indicating the missing API key. Ensure you have created an account at linkupapi.com and configured your API key in the node credentials.
- Timeouts: Requests may time out if the server is slow or network issues occur. Adjust the "Timeout" advanced option to a higher value if needed.
- Rate Limits / Retries: If the API returns errors due to rate limiting or transient failures, the node will retry up to the configured "Retry Count". Increase this count cautiously.
- Invalid Parameter Values: Providing incorrect formats for properties like employee ranges or locations may result in empty or error responses. Validate inputs before running.
- API Response Errors: Any errors returned by the Linkup API will be included in the output JSON under an
errorfield for diagnosis.
Links and References
- Linkup API Documentation – Official site to create accounts and obtain API keys.
- LinkedIn Company Search Use Cases – Examples of how company data can be leveraged for business growth.