Overview
Lusha provides a RESTful API that allows you to query a comprehensive dataset of business profiles and company information. The API offers three main endpoints:
1. Person API - retrieve contact data for a business profile.
2. Company API - retrieve company data based on domain or company name.
3. Prospecting API - query Lusha’s extensive database based on specific criteria (such as industry, seniority, location, and more) to retrieve detailed contact and company information.
All API requests should be made over HTTPS (SSL), and the response bodies are delivered in JSON format.
💡 For more detailed information on request parameters, response structure, and best practices, please refer to our official API documentation.
Authentication
To access the Lusha API, you must authenticate your requests using your API key. This key is unique to your account and is used to identify your usage of the API.
In order to get your API key from Lusha, please visit the API page on your Lusha dashboard. Please remember your API key is private. Make sure you only share it with people you trust.
💡 Only admins/managers with API feature on their plan can access the API key page.
Rate Limiting
Lusha API enforces rate limiting to ensure fair usage and protect against excessive load. You can make up to 50 requests per second to each API endpoint.
Credit Usage
The Credit Usage API enables you to check your current account credit usage, including how many credits have been used and how many remain, categorized by credit type. The API has a rate limit of 5 requests per minute.
Person API
The Person API allows you to look up detailed information about a person using various identifiers, such as their email, LinkedIn URL, full name, company name, or company domain. You can retrieve key data points like Location, Email, Phone number, Linkedin URL, etc.
Bulk Person API
The Bulk Person API allows you to process up to 100 objects per request, making it more efficient for large-scale queries. This reduces the number of API calls and integrates easily with other systems, saving both time and resources.
Credit Usage: Each successful contact match will consume one credit.
Company API
The Company API allows you to retrieve detailed company information based on a company’s domain or name. This endpoint provides essential firmographic data, including industry, employee count, company location, revenue estimates, and other key business details. It is particularly useful for enriching company records in your CRM, performing market research, and streamlining lead qualification processes.
Bulk Company API
For high-volume enrichment, the Bulk Company API enables processing multiple domains or company names in a single request, significantly improving efficiency for large-scale workflows.
Prospecting API
With Lusha’s Prospecting API, you can query Lusha’s extensive database based on specific criteria (such as job title, seniority, location, and more) to retrieve detailed contact and company information.
The Prospecting API is designed to help you generate new records (contacts or leads) for your CRM system, using filters that align with your Ideal Customer Profile (ICP).
The process for retrieving contact information includes 3 main stages:
Select and apply the filters you would like to use.
Query Contacts or Companies using the available filters.
Get full details of Contacts and Companies from the search results.
💡 Note: A credit is charged only in the final step (Step 3: Enrich API).
Several filters are available for contacts and companies. These filters allow you to narrow down your search results by applying various criteria. Please refer to this link, as we will provide a detailed description of each stage involved in the process as well as all the available filters for Prospecting.
Error Handling
Lusha API uses standard HTTP response codes to indicate the status of your request. These codes help you understand whether the request was successful or if there was an issue.
Access our API documentation page to see the full list of codes and their indications.
💡 Note: This feature is only available on our Scale plans.