HDW LinkedIn icon

HDW LinkedIn

Integrate with Horizon Data Wave LinkedIn API

Actions18

Overview

This node integrates with the Horizon Data Wave LinkedIn API to retrieve information about employees of one or more LinkedIn companies. Specifically, the "Get Company Employees" operation allows users to fetch employee profiles based on company URNs and optional search criteria such as keywords, first name, and last name. This is useful for scenarios like talent acquisition, market research, or competitive analysis where you want to gather detailed employee data from specific companies.

For example, a recruiter could input a list of company URNs to get a curated list of employees matching certain skills or names, helping streamline candidate sourcing.

Properties

Name Meaning
Companies Comma-separated list of LinkedIn company URNs (e.g., "company:14064608,company:1441") identifying the target companies whose employees will be retrieved. The node splits this string into an array internally.
Keywords Optional keyword(s) to filter employees by relevant terms in their profiles (e.g., job titles, skills).
First Name Optional exact first name to filter employees.
Last Name Optional exact last name to filter employees.
Count Maximum number of employee results to return. Default is 10.
Timeout Timeout duration in seconds for the API request. Default is 300 seconds.

Output

The node outputs JSON data representing the employee profiles returned by the API. Each item in the output array corresponds to one employee's data object, which typically includes profile details such as name, position, company affiliation, and other LinkedIn profile attributes.

No binary data output is produced by this operation.

Dependencies

  • Requires an active connection to the Horizon Data Wave LinkedIn API.
  • Requires configuration of an API authentication token credential within n8n to authorize requests.
  • The base URL for API requests is https://api.horizondatawave.ai.
  • The node sends POST requests to the endpoint /api/linkedin/company/employees with the specified parameters.

Troubleshooting

  • Empty or incomplete results: Ensure that the company URNs are correctly formatted and valid. Incorrect URNs or companies without public employee data may yield no results.
  • Timeout errors: If the API call times out, consider increasing the "Timeout" property value.
  • Authentication errors: Verify that the API key credential is correctly configured and has sufficient permissions.
  • Rate limiting or quota exceeded: The external API may limit the number of requests; check your API usage limits.
  • Invalid parameter errors: Make sure that all required fields are provided and properly formatted, especially the "Companies" field.

Links and References

Discussion