Documentation
/
Company Enrichment
/
Search Multiple Companies

Lusha API (2.0.0)

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.

Data Source and Privacy

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.

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.

How to Authenticate

When making an API call, include your API key in the api_key header of the request.

Important Notes

  • To obtain your API key, please visit the following link: https://dashboard.lusha.com/enrich/api
  • Your API key is sensitive and should be kept private. Do not share it with anyone outside of your organisation.
  • The API key is used to track and manage your usage of the API, so ensure it is protected from unauthorised access.

Available Endpoints

  • Person Enrichment: Get contact information for individuals
  • Company Enrichment: Get detailed company information
  • Prospecting: Search and enrich contacts and companies based on specific criteria
  • Account Management: Monitor your API credit usage

Rate Limiting

Lusha API enforces rate limiting to ensure fair usage and protect against excessive load.

  • General Rate Limit: You can make up to 50 requests per second to each API endpoint
  • Credit Usage API: Has a specific rate limit of 5 requests per minute

Rate Limit Headers

To monitor your current rate limit status, check the HTTP response headers in your API calls:

HeaderDescription
x-rate-limit-dailyThe total number of requests allowed per day under your current plan
x-daily-requests-leftThe number of requests remaining in your daily quota
x-daily-usageThe number of requests you have made in the current daily period
x-rate-limit-hourlyThe total number of requests allowed per hour under your current plan
x-hourly-requests-leftThe number of requests remaining in your hourly quota
x-hourly-usageThe number of requests you have made in the current hourly period
x-rate-limit-minuteThe total number of requests allowed per minute under your current plan
x-minute-requests-leftThe number of requests remaining in your current minute window
x-minute-usageThe number of requests you have made in the current minute window

Notes on API Rate Limiting

  • If you exceed the rate limit, the API will return a 429 (Too Many Requests) error.
  • To ensure a smooth experience, respect the rate limits defined by your subscription tier.
  • Daily limits vary based on your billing plan — higher tiers have higher quotas.
  • You can programmatically track your usage through these response headers:
    • X-RateLimit-Remaining-Daily
    • X-RateLimit-Reset-Daily
  • It is strongly recommended to implement logic that:
    • Monitors these headers
    • Pauses or retries requests accordingly
    • Helps avoid hitting the limit and ensures reliable operation

Error Codes

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.

Status CodeNameDescription
200OKSuccessful request
400Bad RequestBadly formatted request
401UnauthorizedThe API key is invalid
403ForbiddenYour account is not active. Please reach out to support at support@lusha.com for assistance
403ForbiddenYour pricing version does not support requesting individual datapoints [revealEmails, revealPhones]
404Not FoundThe requested endpoint was not found
412Precondition FailedThe 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
429Too Many RequestsYou've reached your trial limit, please contact support for upgrade
429Too Many RequestsDaily API quota limit exceeded. Limit X calls per day
429Too Many RequestsHourly API rate limit exceeded. Limit: X calls per hour. Reset in X seconds
451Unavailable For Legal ReasonsWe are unable to process this contact request due to our GDPR regulations
499Client Closed RequestRequest failed due to request timeout
5XXServer ErrorThere's a problem on Lusha's end

Error Response Format

In case of an error, the response body will contain details about the error:

{
  "error": {
    "code": 400,
    "message": "Invalid request parameters"
  }
}

Handling Errors

  • Always ensure your API key is correct and valid
  • Pay attention to the specific error message and code to troubleshoot issues efficiently
  • Implement proper error handling and retry logic in your application
  • For 5XX errors, implement exponential backoff before retrying
Download OpenAPI description
openapi.json
openapi.yaml
Overview
URL

https://api.lusha.com

Lusha Support

support@lusha.com

Terms of Service

Languages
Servers
Mock server

https://docs.lusha.com/_mock/apis/openapi/

Production server

https://api.lusha.com/

Person Enrichment

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, Social network URLs.

Operations

Company Enrichment

The Company API allows you to retrieve detailed company information based on a company's domain or name.

Operations

Search Single Company

Request

Find detailed information about a single company using domain name, company name, or company ID.

Note: At least one of domain, company, or companyId is required.

Security
ApiKeyAuth
Query
domainstring

The domain name associated with the company

Example: domain=example.com
companystring

The name of the company

Example: company=Lusha
companyIdstring

A unique identifier for a Lusha company.

Note: Values may be removed or merged. This field is intended for deprecation in the future.

Example: companyId=1234567890
curl -i -X GET \
  'https://docs.lusha.com/_mock/apis/openapi/v2/company?company=Lusha&companyId=1234567890&domain=example.com' \
  -H 'api_key: YOUR_API_KEY_HERE'

Responses

Company information retrieved successfully

Bodyapplication/json
dataobject(CompanySingleResponseData)
errorsobject(CompanyErrorResponse)
metaobject

Currently returns an empty value; this field should be deprecated in future releases.

Example: {}
Response
application/json
{
  "data": {
    "id": 123,
    "description": "Lusha is the sales intelligence platform designed to help businesses get their next customers.",
    "domain": "lusha.com",
    "employees": "201 - 500",
    "founded": "August 1, 2011",
    "fqdn": "www.lusha.com",
    "logoUrl": "https://logo.lusha.co/logo.jpg",
    "name": "Lusha",
    "revenueRange": [ … ],
    "mainIndustry": "Technology",
    "subIndustry": "Software",
    "social": { … },
    "address": "North America United States Boston  800 Boylston St , Suite 1410 , Boston, Massachusetts 02199, US  Massachusetts US MA -71.05976867675781,42.358428955078125 ",
    "location": { … },
    "categories": [ … ],
    "industryPrimaryGroupDetails": { … },
    "website": "https://lusha.com",
    "specialities": [ … ],
    "funding": { … },
    "intent": { … },
    "technologies": [ … ]
  },
  "errors": {
    "message": "Something went wrong"
  },
  "meta": {}
}

Search Multiple Companies

Request

Search for multiple companies in a single request. Provide a list of companies with identifiers like domain names or company IDs.

Rate Limits: Up to 50 requests per second. You can process up to 100 companies per request.

Security
ApiKeyAuth
Bodyapplication/jsonrequired
companiesArray of objects(CompanyBulkRequest)required

The list of companies to search

companies[].​idstringrequired

A unique sequential ID associated with each company. This ID is used to correlate the provided company object with the API response

Example: "1"
companies[].​domainstring

The domain name associated with the company

Example: "lusha.com"
companies[].​fqdnstring

The Fully Qualified Domain Name (FQDN) of the company.

companies[].​namestring

The name of the company

Example: "Lusha"
companies[].​companyIdstring

A unique identifier for a Lusha company. Note: Values may be removed or merged. No management system exists to log historical changes for companyId. This field is intended for deprecation in the future.

Example: "1234567890"
curl -i -X POST \
  https://docs.lusha.com/_mock/apis/openapi/v2/company \
  -H 'Content-Type: application/json' \
  -H 'api_key: YOUR_API_KEY_HERE' \
  -d '{
    "companies": [
      {
        "id": "1",
        "domain": "lusha.com",
        "name": "Lusha"
      }
    ]
  }'

Responses

Bulk company search results

Bodyapplication/json
property name*object(CompanyBulkResponse)additional property
Response
application/json
{
  "property1": {
    "id": 33222678,
    "name": "Lusha",
    "companySize": [ … ],
    "revenueRange": [ … ],
    "fqdn": "www.lusha.com",
    "founded": "2016",
    "description": "Lusha is the sales intelligence platform...",
    "logoUrl": "https://logo.lusha.co/logo.jpg",
    "city": "Boston",
    "state": "Massachusetts",
    "country": "United States",
    "countryIso2": "US",
    "continent": "North America",
    "rawLocation": "string"
  },
  "property2": {
    "id": 33222678,
    "name": "Lusha",
    "companySize": [ … ],
    "revenueRange": [ … ],
    "fqdn": "www.lusha.com",
    "founded": "2016",
    "description": "Lusha is the sales intelligence platform...",
    "logoUrl": "https://logo.lusha.co/logo.jpg",
    "city": "Boston",
    "state": "Massachusetts",
    "country": "United States",
    "countryIso2": "US",
    "continent": "North America",
    "rawLocation": "string"
  }
}

Prospecting

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:

StepAPIDescription
1Filters APIApply filters to refine your search
2Search APIQuery Contacts or Companies using the available filters
3Enrich APIGet full details of Contacts and Companies from the search results

Important Notes:

  • The API KEY header is mandatory for every request to our service.
  • A credit is charged only in the final step (Step 3: Enrich API).

Contact Filters

Available filters for contact searches

Operations

Company Filters

Available filters for company searches

Operations

Contact Search & Enrich

Search and enrich contact data

Operations

Company Search & Enrich

Search and enrich company data

Operations

Account Management

Manage your account and monitor usage

Operations
Terms
Copyright © Lusha. All rights reserved.