Lusha

Lusha API integration for contact and company enrichment

Overview

The node integrates with the Lusha API to enrich company data based on prospecting search results. Specifically, the "Enrich Companies" operation under the "Prospecting" resource allows users to provide a Request ID from previous company search results and select which companies to enrich further. This enrichment fetches detailed information about companies identified in the prospecting phase.

This node is beneficial when you have performed a company search using filters and want to retrieve more comprehensive data for selected companies, such as firmographics or contact details associated with those companies.

Practical example:

  • After searching for companies in a specific industry or location, use this node to enrich all or selected companies from that search with additional data points like revenue, employee count, or technologies used.

Properties

Name Meaning
Request ID The unique identifier of the prospecting search request whose results you want to enrich.
Selection Type How to select companies for enrichment:
- All Companies: Enrich all companies returned by the search.
- Custom Selection: Specify individual company IDs manually (comma-separated).
Company IDs Comma-separated list of company IDs to enrich (used only if Selection Type is "Custom").

Output

The output JSON contains the enriched company data returned by the Lusha API for each requested company. Each item corresponds to one enriched company and includes detailed company information as provided by Lusha's prospecting company enrichment endpoint.

The structure typically includes company identifiers, firmographic data, and any additional enriched fields available from the API response.

No binary data output is produced by this operation.

Dependencies

  • Requires an active Lusha API key credential configured in n8n.
  • Makes HTTP requests to Lusha's API endpoints:
    • https://api.lusha.com/prospecting/company/enrich for company enrichment.
  • The node expects a valid Request ID obtained from a prior prospecting company search operation.
  • Proper network connectivity to Lusha's API service is necessary.

Troubleshooting

  • Error: "Request ID is required"
    This error occurs if the Request ID parameter is empty or missing. Ensure you provide a valid Request ID from a previous company search.

  • Error: "No company IDs found for enrichment"
    Happens when no company IDs are specified for enrichment in "Custom Selection" mode, or when the input data does not contain company IDs in "All Companies" mode. Verify that the company IDs list is correctly set or that the input data contains the expected IDs.

  • Invalid API Key or Authentication Errors
    If the API key credential is invalid or missing, the node will fail to authenticate. Confirm that the Lusha API key is correctly configured in n8n credentials.

  • Rate Limits or API Quotas
    Lusha API may enforce rate limits. If you encounter errors related to quota exceeded, consider reducing request frequency or contacting Lusha support.

Links and References

Discussion