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.
4. Lookalike API - discover similar contacts and companies based on your existing data. Get AI-powered suggestions for new prospects that match your ideal customer profile.
5. Signals API - Enrich contacts and companies with signals like promotions and company growth to uncover new sales opportunities.
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, which you can find on your API page. This key is unique to your account and is used to identify your API usage. Only admins/managers can access the API key.
With Lusha's API, you can build automations using the Lusha API. This feature allows you to integrate Lusha's capabilities into your workflows and automate tasks to save time and effort.
Our API Page is your central hub for all things API, connectors, and automation. There, you can:
Explore real use cases like Contact & Company Enrichment, Prospecting, and Signal Enrichment.
Discover ready-made templates across connectors like Zapier, Make, Pipedream, and Workato.
💡 Note: The API key is shared at the account level. When you click Update, a new key will be generated and the existing one will no longer be valid. This means any active workflows or integrations using the previous key will stop working until they’re updated with the new key.
Rate Limiting
Lusha API enforces rate limiting to ensure fair usage and protect against excessive load.
Each plan has its own rate limit:
Free + Starter users: 5/minute, 10/hour, 25/day
Professional + Premium users: 200/minute, 400/hour, 2000/day
Scale users: 300/minute, 600/hour, 6000/day
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.
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.
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.
Lookalike API
Scaling your outbound strategy doesn't have to feel like a guessing game. Lusha’s Lookalikes API leverages advanced machine learning to turn your best customers into a blueprint for future growth. By analyzing your successful conversions, the API identifies hidden patterns and surfaces high-value prospects that you might have otherwise missed.
The Lookalikes API functions as an automated bridge between your "Ideal Customer Profile" (ICP) and a massive database of verified leads. Instead of manual filtering, you receive data-driven recommendations that mirror your most successful accounts.
Core Functionalities
Contact Lookalikes Go beyond simple job titles. This feature analyzes deep professional attributes - including specific roles, seniority levels, and industry-specific career trajectories - to find professionals who share the same decision-making power and functional DNA as your top-performing contacts.
Company Lookalikes Mirror your best-fit accounts by identifying organizations with matching firmographic footprints. The API scans for similarities in industry vertical, employee headcount, annual revenue, and organizational characteristics to ensure you are targeting companies with the highest propensity to buy.
To learn how Lookalike API works, visit our Lookalike API documentation.
Signals API
With Lusha’s Signals API, you can enrich your contacts and companies with timely insights that highlight key account and prospect changes. Signals help you identify moments of opportunity - from job moves and promotions to company growth and new initiatives - so you can engage prospects and customers at exactly the right time. Easily integrate signal data into enrichment flows, CRM systems, or automation workflows to keep pipelines and customer records always up to date.
For more details on our Signals API, check our documentation here.
Credit Consumption
Lusha’s API credit usage is calculated based on two key components:
1. Data Points Revealed
When you retrieve specific information about a contact or company, credits are consumed based on the type of data revealed:
Data Point Type | Credit Cost |
1 credit | |
Phone Number | 5 credits |
Company Info | 1 credit |
💡 Note: Each contact’s data point is only charged once. If you’ve already revealed a contact’s email or phone number, future requests will not incur additional charges for those same data points.
2. Number of API Results Returned
Credit charges also apply based on how many results are returned, and whether it’s a single or bulk request:
Request Type | Results Returned | Credit Cost |
Single Request | Per result (1 contact/company) | 1 credit per result |
Bulk Request | Up to 25 results | 1 credit per 1–25 results |
For example, revealing both an email and a phone number for the same contact typically costs 7 credits in total: 5 credits for the phone number, 1 credit for the email, and 1 credit for the API request.
A single request is when you query one contact or company.
A bulk request includes multiple contacts/companies (up to 100) per request.
The bulk pricing is much more efficient - up to 25 results for just 1 credit per request, versus 1 credit per individual result in single requests.
Sales Intelligence (Signals)
Charged on a per-signal per contact or percompany basis
Growth Surge in Hiring: 1 credit per company
Growth in Headcount: 1 credit per company
Job Change: 1 credit per contact
Caveats to Keep in Mind
Minimum of 1 credit per API request applies, even if no results or data points are returned.
Maximum of 100 contacts or companies per request.
Data points are only charged once per contact; subsequent reveals of the same contact will not be recharged.
Manage API Key Credit Limits
You can now monitor and control credit consumption for each individual API key in your account. This allows you to attribute usage to specific workflows - like Zapier, Make, or internal AI tools- and set monthly caps to prevent a single automation from exhausting your entire account balance.
Key features for credit governance:
Real-time Tracking: View exactly how many credits each key has consumed during the current billing cycle directly from the Manage API keys table.
Monthly Limits: Set a specific "hard limit" for any key. Once this limit is reached, requests using that key will be blocked until the next cycle, while your other API keys remain active. To learn about your cycle setting, head to this article.
Automatic Resets: All individual key limits reset automatically at the start of your account's cycle.
How to set a credit limit for an API key
Navigate to API → Manage API keys.
Locate the key you want to modify in the list.
Click the Edit (pencil icon) or Set limit link in the Credit usage column.
In the Edit Key side panel, toggle on the limit option and enter the maximum number of credits this key is allowed to use per month.
Click Continue to save your changes.
💡 Note: Only Account Admins can set or edit credit limits. The sum of all individual API key limits cannot exceed your total account credit allowance.
To remove a limit, click the Edit (pencil icon). On the right side panel, next to the limit, press "Remove".
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.