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 (industry, seniority, location, etc.) to retrieve detailed contact and company information.

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.

Authentication

To access the Lusha API, include your API key in each request. This key is unique to your account and must be kept private.

1. Visit the API page on your Lusha dashboard to retrieve your key.
2. 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.

Rate Limiting

To ensure fair usage and protect against excessive load, Lusha enforces the following rate limits:

• All endpoints: Up to 50 requests per second per endpoint.

Credit Usage

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.

Person API

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
• Email
• Phone number
• LinkedIn URL
• …and more

Bulk Person API

Process up to 100 person objects per request to reduce API calls and integrate seamlessly with large-scale workflows.

Credit Usage: Each successful contact match consumes 1 credit.

Company API

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.

Bulk Company API

Enrich multiple domains or company names in a single request to streamline high-volume workflows.

Prospecting API

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

Workflow

1. Apply filters – Select the criteria you need.
2. Search – Query contacts or companies based on those filters.
3. Enrich – Retrieve full details for each result using the Enrich API.

💡 A credit is charged only in the final “Enrich” step.

For a full list of available filters and detailed stage-by-stage guidance, see our Prospecting API reference.

Error Handling

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.

💡 Error-handling features are available on Scale plans only.