Lusha provides a RESTful API that allows you to query a comprehensive dataset of business profiles and company information. The API offers five main endpoints:
- Person API – Retrieve contact data for a business profile.
- Company API – Retrieve company data based on domain or company name.
- Prospecting API – Query Lusha’s extensive database based on specific criteria (industry, seniority, location, etc.) to retrieve detailed contact and company information.
- Signals API - Delivers real-time buying intent and market signals directly into your workflows.
- Recomendations API - discover similar contacts and companies based on your existing data.
All API requests must be made over HTTPS (SSL), and responses are delivered in JSON format.
💡 For detailed information on request parameters, response structure, and best practices, please refer to our official API documentation.
To access the Lusha API, include your API key in each request. This key is unique to your account and must be kept private.
- Visit the API page on your Lusha dashboard to retrieve your key.
- Share it only with trusted individuals - your API key grants full access to your account.
💡 Only admins/managers with the API feature on their plan can view the API key page.
To ensure fair usage and protect against excessive load, Lusha enforces the following rate limits:
- All endpoints above: Up to 25 requests per second per endpoint.
The Credit Usage API lets you monitor your account’s credit consumption:
- Check how many credits have been used and how many remain, by credit type.
- Rate limit: 5 requests per minute.
Look up detailed information about a person using identifiers such as email, LinkedIn URL, full name + company name, or company domain. You can retrieve:
- Location
- Phone number
- LinkedIn URL
- …and more
Process up to 100 person objects per request to reduce API calls and integrate seamlessly with large-scale workflows.
Retrieve firmographic data for a company using its domain or name. Data points include:
- Industry
- Employee count
- Location
- Revenue estimates
- …and other key business details
Ideal for CRM enrichment, market research, and lead qualification.
Enrich multiple domains or company names in a single request to streamline high-volume workflows.
Generate new leads/contacts for your CRM by applying filters that match your Ideal Customer Profile (ICP). Available filters include:
- Job title
- Seniority
- Location
- Industry
- …and more
- Apply filters – Select the criteria you need.
- Search – Query contacts or companies based on those filters.
- Enrich – Retrieve full details for each result using the Enrich API.
For a full list of available filters and detailed stage-by-stage guidance, see our Prospecting API reference.
Monitor real-time market changes and buying intent signals to identify high-priority prospects. The Signals API tracks:
- Job changes and promotions
- Company growth indicators
- Technology adoption
- Funding events
- Leadership changes
- …and other buying signals
- Configure signal types – Select which signals to monitor.
- Set target criteria – Define your ICP for signal monitoring.
- Retrieve signals – Pull signals via API or webhook notifications.
- Enrich signal data – Use Person/Company APIs for complete profiles.
Discover lookalike contacts and companies based on your existing customer data. The Recommendations API uses machine learning to identify:
- Similar companies to your best customers
- Contacts with comparable profiles to your top leads
- Expansion opportunities within existing accounts
- New market segments aligned with your ICP
- Provide seed data – Submit existing contact or company ID's.
- Receive recommendations – Get ranked lists of similar profiles.
- Enrich recommendations – Use enrichment APIs for complete data.
Lusha API uses standard HTTP status codes to indicate request outcomes:
- 2xx – Success
- 4xx – Client error (e.g., malformed request, authentication issues)
- 5xx – Server error
Access our API documentation for the complete list of codes and their meanings.