HDW LinkedIn icon

HDW LinkedIn

Integrate with Horizon Data Wave LinkedIn API

Overview

The node integrates with the Horizon Data Wave LinkedIn API to perform various LinkedIn-related data retrieval operations. Specifically, the Search Companies operation under the Search resource allows users to search for LinkedIn companies based on keywords and optional filters such as location, industry, and employee count.

This operation is useful for scenarios like:

  • Market research to find companies matching specific criteria.
  • Lead generation by identifying companies in certain industries or locations.
  • Competitive analysis by filtering companies by size or sector.

For example, a user can search for companies with the keyword "software" located in "San Francisco" within the "Technology" industry and having between 51-200 employees.

Properties

Name Meaning
Keywords Any keyword(s) for searching companies. For exact matches, put keywords inside brackets.
Count Maximum number of results to return (default is 10).
Timeout Timeout duration in seconds for the API request (default is 300 seconds).
Additional Filters Optional filters to narrow down the search results:
- Location Location URN (e.g., geo:*) or location name to filter companies by geographic area.
- Industry Industry URN (e.g., industry:*) or industry name to filter companies by sector.
- Employee Count Company size ranges to filter by, options include:
1-10, 11-50, 51-200, 201-500, 501-1,000, 1,001-5,000, 5,001-10,000, 10,001+

Output

The output is a JSON array where each item represents a company matching the search criteria. Each JSON object contains company details as returned by the Horizon Data Wave LinkedIn API. The exact structure depends on the API response but typically includes company name, industry, location, size, and other relevant metadata.

The node does not output binary data for this operation.

Dependencies

  • Requires an API key credential for the Horizon Data Wave LinkedIn API.
  • The base URL for API requests is https://api.horizondatawave.ai.
  • The node uses HTTP POST requests with JSON bodies to interact with the API.
  • Proper configuration of the API authentication credential in n8n is necessary.

Troubleshooting

  • Timeouts: If the API request times out, consider increasing the "Timeout" property value.
  • No Results: Ensure that the keywords and filters are correctly specified; overly restrictive filters may yield no results.
  • API Errors: Common errors include invalid credentials or exceeding rate limits. Check the error message details returned in the output.
  • Invalid Filter Values: Make sure that location and industry values are valid URNs or recognized names.
  • Network Issues: Verify network connectivity to https://api.horizondatawave.ai.

If the node throws an error with detailed API error information, review the HTTP status code and error messages included in the output for guidance.

Links and References

Discussion