Lusha

Lusha API integration for contact and company enrichment

Actions8

Overview

The "Search Companies" operation in the Prospecting resource allows users to search for companies using a variety of detailed filters. This node interacts with an external API to retrieve company data based on criteria such as company names, domains, employee counts, industries, revenue ranges, locations, and other business attributes.

This node is beneficial for sales, marketing, or recruitment professionals who want to build targeted lists of companies matching specific profiles. For example, a user could find technology companies headquartered in the United States with 100-500 employees and revenues between $10M and $100M.

Practical examples:

  • Finding potential clients in the healthcare industry with over 1,000 employees.
  • Searching for companies using specific technologies like Salesforce or AWS.
  • Filtering companies by geographic location such as Germany or Canada.

Properties

Name Meaning
Page Page number of results to retrieve (starts at 0).
Page Size Number of results per page, ranging from 10 to 40.
Company Filters Collection of filters to narrow down the company search:
- Company Names Comma-separated list of company names to include (e.g., Microsoft, Apple, Google).
- Domains Comma-separated list of company domains (e.g., microsoft.com, apple.com).
- Employee Count Select one or more employee count ranges: 1-10, 11-50, 51-200, 201-500, 501-1000, 1001-5000, 5001-10000, 10001+.
- Industries Select main industries from options like Technology, Finance, Healthcare, Retail, Manufacturing, etc.
- Revenue Min Minimum company revenue filter; options range from Any, $0, $1M, $10M, $50M, $100M, $500M, to $1B.
- Revenue Max Maximum company revenue filter; options range from Any, $1M, $10M, $50M, $100M, $500M, $1B, to $10B+.
- Sub Industries Select sub-industries such as Software Development, Internet Services, Financial Services, Biotechnology, Pharmaceuticals, Cloud Computing, Cybersecurity, AI, etc.
- Company Countries Select countries where the company headquarters are located (e.g., United States, United Kingdom, Canada, Australia, Germany, France, India, Brazil, etc.).
- SIC Codes Comma-separated Standard Industrial Classification codes (e.g., 7372, 7373, 7374).
- NAICS Codes Comma-separated North American Industry Classification System codes (e.g., 511210, 541511, 541512).
- Technologies Comma-separated list of technologies used by companies (e.g., Salesforce, HubSpot, AWS).
- Intent Topics Comma-separated intent topics indicating company interests (e.g., Digital Transformation, Cloud Migration).

Output

The output JSON contains the search results returned by the external API. It includes:

  • data: An array of company objects matching the search criteria.
  • Pagination metadata such as:
    • totalResults: Total number of matching companies.
    • pageLength: Number of results per page.
    • totalPages: Calculated total pages available.
    • currentPage: The current page index.
    • isFirstPage / isLastPage: Booleans indicating if the current page is the first or last.
  • allCompanyIds: Array of all company IDs found in the current result set.

Each company object typically includes identifiers and company details as provided by the API.

No binary data output is produced by this operation.

Dependencies

  • Requires an API key credential for authentication with the external Lusha API.
  • The node makes HTTP requests to the Lusha API endpoints for prospecting company searches.
  • Proper configuration of the API key credential in n8n is necessary.

Troubleshooting

  • Invalid JSON Errors: If input fields expecting JSON (not applicable here for Search Companies) are malformed, errors will be thrown. Ensure JSON inputs are correctly formatted.
  • Missing or Invalid API Key: The node requires a valid API key credential. Errors related to authentication indicate missing or incorrect API keys.
  • Empty Results: If no companies match the filters, the output data array will be empty. Adjust filters to broaden the search.
  • Pagination Issues: Requesting pages beyond the available range may return empty results. Use pagination metadata (totalPages) to control paging.
  • Filter Format: Comma-separated strings must not contain trailing commas or extra spaces; otherwise, filters might not apply correctly.

Links and References

Discussion