Lusha provides a RESTful API that allows you to query a comprehensive dataset of business profiles and company information.
All API requests should be made over HTTPS (SSL), and the response bodies are delivered in JSON format.
Please note that Lusha is a search platform, meaning the data provided is not created or directly managed by us. Instead, it is retrieved from publicly available sources and through contributions from trusted business partners.
For more information on how we collect, use, and handle business profiles, please refer to our Privacy Policy.
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.
When making an API call, include your API key in the api_key header of the request.
Lusha API enforces rate limiting to ensure fair usage and protect against excessive load.
To monitor your current rate limit status, check the HTTP response headers in your API calls:
| Header | Description |
|---|---|
x-rate-limit-daily | The total number of requests allowed per day under your current plan |
x-daily-requests-left | The number of requests remaining in your daily quota |
x-daily-usage | The number of requests you have made in the current daily period |
x-rate-limit-hourly | The total number of requests allowed per hour under your current plan |
x-hourly-requests-left | The number of requests remaining in your hourly quota |
x-hourly-usage | The number of requests you have made in the current hourly period |
x-rate-limit-minute | The total number of requests allowed per minute under your current plan |
x-minute-requests-left | The number of requests remaining in your current minute window |
x-minute-usage | The number of requests you have made in the current minute window |
X-RateLimit-Remaining-DailyX-RateLimit-Reset-DailyLusha 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.
| Status Code | Name | Description |
|---|---|---|
| 200 | OK | Successful request |
| 400 | Bad Request | Badly formatted request |
| 401 | Unauthorized | The API key is invalid |
| 403 | Forbidden | Your account is not active. Please reach out to support at support@lusha.com for assistance |
| 403 | Forbidden | Your pricing version does not support requesting individual datapoints [revealEmails, revealPhones] |
| 404 | Not Found | The requested endpoint was not found |
| 412 | Precondition Failed | The request failed due to invalid syntax that was provided. Please make sure to send a full name field that contains a valid first & last name |
| 429 | Too Many Requests | You've reached your trial limit, please contact support for upgrade |
| 429 | Too Many Requests | Daily API quota limit exceeded. Limit X calls per day |
| 429 | Too Many Requests | Hourly API rate limit exceeded. Limit: X calls per hour. Reset in X seconds |
| 451 | Unavailable For Legal Reasons | We are unable to process this contact request due to our GDPR regulations |
| 499 | Client Closed Request | Request failed due to request timeout |
| 5XX | Server Error | There's a problem on Lusha's end |
In case of an error, the response body will contain details about the error:
{
"error": {
"code": 400,
"message": "Invalid request parameters"
}
}https://docs.lusha.com/_mock/apis/openapi/
https://api.lusha.com/
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).
This process involves three main steps:
| Step | API | Description |
|---|---|---|
| 1 | Filters API | Apply filters to refine your search |
| 2 | Search API | Query Contacts or Companies using the available filters |
| 3 | Enrich API | Get full details of Contacts and Companies from the search results |
Important Notes:
https://docs.lusha.com/_mock/apis/openapi/prospecting/contact/search
https://api.lusha.com/prospecting/contact/search
curl -i -X POST \
https://docs.lusha.com/_mock/apis/openapi/prospecting/contact/search \
-H 'Content-Type: application/json' \
-H 'api_key: YOUR_API_KEY_HERE' \
-d '{
"pages": {
"page": 0,
"size": 20
},
"offset": {
"index": 0,
"size": 40
},
"filters": {
"contacts": {
"include": {
"departments": [
"Engineering & Technical"
],
"seniority": [
"2"
],
"existing_data_points": [
"phone",
"work_email"
],
"locations": [
{
"continent": "North America",
"country": "United States",
"city": "New York",
"state": "New York",
"country_grouping": "na"
}
]
},
"exclude": {}
},
"companies": {
"include": {
"names": [
"Apple"
],
"locations": [
{
"country": "United States"
}
],
"technologies": [
"Amazon"
],
"mainIndustriesIds": [
"1",
"2"
],
"subIndustriesIds": [
"string"
],
"intentTopics": [
"Digital Sales"
],
"sizes": [
{
"min": 1,
"max": 10
}
],
"revenues": [
{
"min": 1,
"max": 1000000
}
],
"sics": [
"string"
],
"naics": [
"string"
]
},
"exclude": {}
}
}
}'{ "requestId": "string", "currentPage": 0, "totalResults": 0, "contacts": [ { … } ] }
The requestId generated in the Prospecting Search response (UUID)
https://docs.lusha.com/_mock/apis/openapi/prospecting/contact/enrich
https://api.lusha.com/prospecting/contact/enrich
curl -i -X POST \
https://docs.lusha.com/_mock/apis/openapi/prospecting/contact/enrich \
-H 'Content-Type: application/json' \
-H 'api_key: YOUR_API_KEY_HERE' \
-d '{
"requestId": "b6effae6-35b8-493d-91aa-7d3b1b7c7dc7",
"contactIds": [
"37b4c536-eaec-11ef-ad4b-a75f8e9e1484"
]
}'{ "requestId": "string", "contacts": [ { … } ] }