HDW LinkedIn icon

HDW LinkedIn

Integrate with Horizon Data Wave LinkedIn API
Join our community

Actions19

Overview

This node performs an advanced LinkedIn user search using the Sales Navigator API. It allows users to find LinkedIn profiles based on a wide range of detailed criteria such as keywords, names, titles, companies, locations, industries, languages, job functions, and more. This is particularly useful for sales professionals, recruiters, or marketers who want to target specific audiences or leads with precision.

Typical use cases include:

  • Finding potential sales leads matching specific job titles and company sizes.
  • Recruiting candidates with particular skills, education, or experience.
  • Market research by filtering professionals in certain industries or locations.
  • Identifying active LinkedIn users who recently posted content.

Properties

Name Meaning
Keywords Any keyword(s) to search within user profiles.
Count Maximum number of results to return (up to 2500).
Timeout Request timeout in seconds (range: 20 to 1500).
Additional Filters Collection of optional filters to refine the search:
- First Names Comma-separated list of exact first names to match.
- Last Names Comma-separated list of exact last names to match.
- Current Titles Comma-separated list of exact words to match in current job titles.
- Past Titles Comma-separated list of exact words to match in past job titles.
- Company Keyword Keyword filter for the current company name.
- Past Company Keyword Keyword filter for past company names.
- Location Location name or URN; can be a single value or comma-separated list.
- Industry Industry URN or name.
- Current Companies Current company URN(s) or name(s); can be single or multiple comma-separated values.
- Past Companies Past company URN(s) or name(s); can be single or multiple comma-separated values.
- Education Education URN(s) or name(s); can be single or multiple comma-separated values.
- Company Locations Company location name(s) or URN(s); can be single or multiple comma-separated values.
- Is Posted On LinkedIn Boolean flag to filter users who have recently published content on LinkedIn.
- Company Sizes Select one or more company size ranges from options like Self-Employed, 1-10, 11-50, up to 10,001+.
- Company Types Select one or more types of current companies such as Public Company, Privately Held, Non Profit, Educational Institution, Partnership, Self Employed, Self Owned, Government Agency.
- Languages Select one or more profile languages from a list including English, Spanish, Chinese, French, German, etc.
- Functions Select one or more job functions such as Accounting, Marketing, Engineering, Sales, Human Resources, etc.
- Levels Select one or more job levels like Entry, Director, Owner, CXO, Vice President, Senior, etc.
- Years in Current Company Select one or more ranges for years spent in the current company (e.g., 0-1, 1-2, 3-5, 6-10, 10+).
- Years in Current Position Select one or more ranges for years spent in the current position (e.g., 0-1, 1-2, 3-5, 6-10, 10+).

Output

The node outputs JSON data representing the search results returned by the Sales Navigator API. The structure typically includes an array of user profiles matching the search criteria, each containing details such as names, job titles, companies, locations, and other relevant LinkedIn profile information.

If multiple items are returned, each item is output as a separate JSON object in the node's output array.

No binary data output is produced by this operation.

Dependencies

  • Requires an API key credential for authenticating with the Horizon Data Wave LinkedIn API.
  • The node makes HTTP POST requests to the endpoint https://api.horizondatawave.ai/api/linkedin/sn_search/users.
  • Proper configuration of the API key credential in n8n is necessary for successful execution.

Troubleshooting

  • Common Issues:

    • Exceeding the maximum allowed count (over 2500) may cause errors or truncated results.
    • Providing invalid URNs or malformed comma-separated lists in filters might lead to unexpected results or API errors.
    • Network timeouts if the timeout parameter is set too low for large queries.
    • Missing or invalid API credentials will result in authentication failures.

  • Error Messages:

    • API errors often include HTTP status codes and error messages in response headers or body.
    • Typical errors include rate limiting, invalid parameters, or authentication failures.
    • To resolve, verify API credentials, ensure parameters conform to expected formats, and adjust timeout/count settings as needed.
    • If "No detailed error information available" appears, check network connectivity and API service status.

  • Handling Failures:

    • The node supports continuing on failure, which returns error details in the output JSON instead of stopping execution.

Links and References

Discussion