Skip to content
/
Search Single Company

Lusha API (2.0.0)

Lusha provides a RESTful API that allows you to query a comprehensive dataset of business profiles and company information.

Getting Started

To use the Lusha API, you'll need an API key. Include it in the api_key header with each request.

Main Features

  • Person Search: Find contact information for individuals
  • Company Search: Get detailed company information
  • Account Usage: Monitor your API credit usage
Download OpenAPI description
index2.json
index2.yaml
Overview
URL
https://lusha.com/support
Lusha Support
support@lusha.com
License
Lusha API License
Terms of Service
Languages
Servers
Mock server
https://docs.lusha.com/_mock/apis/index2/
Production server
https://api.lusha.com/
Staging server
https://api-staging.lusha.com/

Person

Search for individual contacts and their information

Operations

Company

Search for company information and details

Operations

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.

Security
ApiKeyAuth
Bodyapplication/jsonrequired

List of companies to search for

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[].​domainstringrequired

The domain name associated with the company

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

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

companies[].​namestringrequired

The name of the company

Example: "Lusha"
companies[].​companyIdstringrequired

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/index2/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
1objectrequired

A map of companies keyed by ID string.

1.​idnumberrequired

A unique identifier for the Lusha company.

Example: 33222678
1.​namestringrequired

The name of the company.

Example: "Lusha"
1.​companySizeArray of stringsrequired

The size range of the company, based on number of employees.

Example: [201,500]
1.​revenueRangeArray of stringsrequired

The company's revenue range.

Example: [10000000,50000000]
1.​fqdnstringrequired

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

Example: "www.lusha.com"
1.​foundedstringrequired

The date the company was founded.

Example: "2016"
1.​descriptionstringrequired

A brief description of the company.

Example: "Lusha is the sales intelligence platform..."
1.​logoUrlstringrequired

The URL of the company's logo.

Example: "https://logo.lusha.co/brightdata/year=2024/month=05/day=03/j_lvq47h0g13te1b3wpu.e7b0795e7affc9953dadd43e6fce99a2c5260043.file_lvq4cfwv17kcb9m4ej.logo_cached.jpg"
1.​citystringrequired

The city where the company is located.

Example: "Boston"
1.​statestringrequired

The state where the company is located.

Example: "Massachusetts"
1.​countrystringrequired

The country where the company is located.

Example: "United States"
1.​countryIso2stringrequired

The 2-letter ISO country code.

Example: "US"
1.​continentstringrequired

The continent where the company is located.

Example: "North America"
1.​rawLocationstringrequired

The detailed address.

Example: "800 Boylston St, Suite 1410, Boston, MA 02199, US"
1.​linkedinstringrequired

LinkedIn profile URL.

Example: "https://www.linkedin.com/company/lushadata"
1.​crunchbasestringrequired

Crunchbase profile URL.

Example: "https://www.crunchbase.com/organization/lusha"
1.​industryTagsArray of stringsrequired

LinkedIn industry tags.

Example: ["Sales Intelligence","Lead Generation"]
1.​specialitiesArray of stringsrequired

LinkedIn specialties.

Example: ["lead gen","sales enablement"]
1.​industryPrimaryGroupDetailsobjectrequired

SIC and NAICS classification.

1.​industryPrimaryGroupDetails.​sicsArray of objects(CompanySic)required
1.​industryPrimaryGroupDetails.​sics[].​sicnumberrequired
Example: 1234
1.​industryPrimaryGroupDetails.​sics[].​descriptionstringrequired
Example: "Software Publishing"
1.​industryPrimaryGroupDetails.​naicsArray of objects(CompanyNaics)required
1.​industryPrimaryGroupDetails.​naics[].​naicsnumberrequired
Example: 541511
1.​industryPrimaryGroupDetails.​naics[].​descriptionstringrequired
Example: "Custom Computer Programming Services"
1.​fundingobjectrequired

Details about company funding.

1.​funding.​roundsArray of objects(CompanyFundingRound)required

List of funding rounds

1.​funding.​rounds[].​currencystringrequired

Currency of the funding round

Example: "USD"
1.​funding.​rounds[].​roundAmountnumberrequired

Amount raised in the round

Example: 205000000
1.​funding.​rounds[].​roundTypestringrequired

Type of funding round

Example: "Private Equity Round"
1.​funding.​rounds[].​roundDatestringrequired

Date of the funding round

Example: "Nov 10, 2021"
1.​funding.​totalRoundsnumberrequired

Total number of rounds

Example: 2
1.​funding.​totalRoundsAmountnumberrequired

Total amount raised across all rounds

Example: 245000000
1.​funding.​currencystringrequired

Currency used

Example: "USD"
1.​funding.​isIpobooleanrequired

Whether the company has gone public

Example: false
1.​funding.​lastRoundTypestringrequired

Type of the last funding round

Example: "Private Equity Round"
1.​funding.​lastRoundAmountnumberrequired

Amount of the last funding round

Example: 205000000
1.​funding.​lastRoundDatestringrequired

Date of the last funding round

Example: "Nov 10, 2021"
1.​intentobjectrequired

Detected topics of interest based on behavior.

1.​intent.​detectedTopicsArray of objects(CompanyIntentTopic)required

Detected intent topics

1.​intent.​detectedTopics[].​topicNamestringrequired

Name of the intent topic

Example: "Remote Sales"
1.​intent.​detectedTopics[].​metadataobject(CompanyIntentTopicMetadata)required
1.​intent.​detectedTopics[].​metadata.​topicScorenumberrequired

Relevance score for the intent topic

Example: 83
1.​intent.​detectedTopics[].​metadata.​topicTrendstringrequired

Trend of the topic (e.g., +1, -5, New)

Example: "-5"
1.​intent.​topicCountnumberrequired

Number of topics detected

Example: 6
1.​technologiesArray of objects(CompanyTechnology)required

Technologies used by the company.

1.​technologies[].​namestringrequired

Technology name used by the company

Example: "salesforce"
1.​mainIndustrystringrequired

The primary industry sector in which the company operates.

Example: "Technology, Information & Media"
1.​subIndustrystringrequired

The specific sub-sector within the primary industry.

Example: "Software Development"
1.​twitterstringrequired

The Twitter handle of the company.

Example: "https://twitter.com/lusha"
1.​facebookstringrequired

The Facebook handle of the company.

Example: "https://www.facebook.com/lusha"
Response
application/json
{
  "1": {
    "id": 33222678,
    "name": "Lusha",
    "companySize": [ … ],
    "revenueRange": [ … ],
    "fqdn": "www.lusha.com",
    "founded": "2016",
    "description": "Lusha is the sales intelligence platform...",
    "logoUrl": "https://logo.lusha.co/brightdata/year=2024/month=05/day=03/j_lvq47h0g13te1b3wpu.e7b0795e7affc9953dadd43e6fce99a2c5260043.file_lvq4cfwv17kcb9m4ej.logo_cached.jpg",
    "city": "Boston",
    "state": "Massachusetts",
    "country": "United States",
    "countryIso2": "US",
    "continent": "North America",
    "rawLocation": "800 Boylston St, Suite 1410, Boston, MA 02199, US",
    "linkedin": "https://www.linkedin.com/company/lushadata",
    "crunchbase": "https://www.crunchbase.com/organization/lusha",
    "industryTags": [ … ],
    "specialities": [ … ],
    "industryPrimaryGroupDetails": { … },
    "funding": { … },
    "intent": { … },
    "technologies": [ … ],
    "mainIndustry": "Technology, Information & Media",
    "subIndustry": "Software Development",
    "twitter": "https://twitter.com/lusha",
    "facebook": "https://www.facebook.com/lusha"
  }
}

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/index2/v2/company?domain=example.com&company=Lusha&companyId=1234567890' \
  -H 'api_key: YOUR_API_KEY_HERE'

Responses

Company information retrieved successfully

Bodyapplication/json
dataobject(CompanySingleResponseData)required
data.​idnumberrequired

A unique identifier for the Lusha company.

Example: 123
data.​descriptionstringrequired

A brief description of the company.

Example: "Lusha is the sales intelligence platform designed to help businesses get their next customers."
data.​domainstringrequired

The domain name associated with the company's email addresses.

Example: "lusha.com"
data.​employeesstringrequired

The company's employee size range.

Example: "201 - 500"
data.​foundedstringrequired

The year the company was founded.

Example: "August 1, 2011"
data.​fqdnstringrequired

The fully qualified domain name of the company.

Example: "www.lusha.com"
data.​logoUrlstringrequired

The URL of the company's logo.

Example: "https://logo.lusha.co/brightdata/year=2024/month=05/day=03/j_lvq47h0g13te1b3wpu.e7b0795e7affc9953dadd43e6fce99a2c5260043.file_lvq4cfwv17kcb9m4ej.logo_cached.jpg"
data.​namestringrequired

The name of the company.

Example: "Lusha"
data.​revenueRangeArray of numbersrequired

The company's revenue range.

Example: [1000000,10000000]
data.​mainIndustrystringrequired

The main industry of the company.

Example: "Technology"
data.​subIndustrystringrequired

The specific sub-sector within the primary industry.

Example: "Software"
data.​socialobjectrequired

Social media links associated with the company.

data.​social.​crunchbaseobject(CompanyCrunchbaseResponse)required
data.​social.​crunchbase.​urlstringrequired
Example: "https://crunchbase.com/company/lusha"
data.​social.​linkedinobject(CompanyLinkedinResponse)required
data.​social.​linkedin.​urlstringrequired
Example: "https://linkedin.com/company/lusha"
data.​addressstringrequired

The full address of the company's location.

Example: "North America United States Boston 800 Boylston St , Suite 1410 , Boston, Massachusetts 02199, US Massachusetts US MA -71.05976867675781,42.358428955078125 "
data.​locationobjectrequired

An object containing the company's location details.

data.​location.​citystringrequired
Example: "Anytown"
data.​location.​countrystringrequired
Example: "USA"
data.​location.​fullLocationstringrequired
Example: "123 Main St, Anytown, USA"
data.​location.​statestringrequired
Example: "CA"
data.​location.​stateCodestringrequired
Example: "CA"
data.​location.​countryIso2stringrequired
Example: "US"
data.​location.​rawLocationstringrequired
Example: "123 Main St, Anytown, USA"
data.​categoriesArray of stringsrequired

LinkedIn industry tags for the company.

Example: ["Technology","Software"]
data.​industryPrimaryGroupDetailsobject(CompanyIndustryPrimaryGroupDetails)required
data.​industryPrimaryGroupDetails.​sicsArray of objects(CompanySic)required
data.​industryPrimaryGroupDetails.​sics[].​sicnumberrequired
Example: 1234
data.​industryPrimaryGroupDetails.​sics[].​descriptionstringrequired
Example: "Software Publishing"
data.​industryPrimaryGroupDetails.​naicsArray of objects(CompanyNaics)required
data.​industryPrimaryGroupDetails.​naics[].​naicsnumberrequired
Example: 541511
data.​industryPrimaryGroupDetails.​naics[].​descriptionstringrequired
Example: "Custom Computer Programming Services"
data.​websitestringrequired

The company's website URL.

Example: "https://lusha.com"
data.​specialitiesArray of stringsrequired

LinkedIn specialties tags associated with the company.

Example: ["Sales","Marketing"]
data.​fundingobjectrequired

Details regarding the company's funding activities.

data.​funding.​roundsArray of objects(CompanyFundingRound)required

List of funding rounds

data.​funding.​rounds[].​currencystringrequired

Currency of the funding round

Example: "USD"
data.​funding.​rounds[].​roundAmountnumberrequired

Amount raised in the round

Example: 205000000
data.​funding.​rounds[].​roundTypestringrequired

Type of funding round

Example: "Private Equity Round"
data.​funding.​rounds[].​roundDatestringrequired

Date of the funding round

Example: "Nov 10, 2021"
data.​funding.​totalRoundsnumberrequired

Total number of rounds

Example: 2
data.​funding.​totalRoundsAmountnumberrequired

Total amount raised across all rounds

Example: 245000000
data.​funding.​currencystringrequired

Currency used

Example: "USD"
data.​funding.​isIpobooleanrequired

Whether the company has gone public

Example: false
data.​funding.​lastRoundTypestringrequired

Type of the last funding round

Example: "Private Equity Round"
data.​funding.​lastRoundAmountnumberrequired

Amount of the last funding round

Example: 205000000
data.​funding.​lastRoundDatestringrequired

Date of the last funding round

Example: "Nov 10, 2021"
data.​intentobjectrequired

A list of detected intent topics related to the company based on your account's mapped topics.

data.​intent.​detectedTopicsArray of objects(CompanyIntentTopic)required

Detected intent topics

data.​intent.​detectedTopics[].​topicNamestringrequired

Name of the intent topic

Example: "Remote Sales"
data.​intent.​detectedTopics[].​metadataobject(CompanyIntentTopicMetadata)required
data.​intent.​detectedTopics[].​metadata.​topicScorenumberrequired

Relevance score for the intent topic

Example: 83
data.​intent.​detectedTopics[].​metadata.​topicTrendstringrequired

Trend of the topic (e.g., +1, -5, New)

Example: "-5"
data.​intent.​topicCountnumberrequired

Number of topics detected

Example: 6
data.​technologiesArray of objects(CompanyTechnology)required

A list of technologies associated with the company.

data.​technologies[].​namestringrequired

Technology name used by the company

Example: "salesforce"
errorsobject(CompanyErrorResponse)required
errors.​messagestringrequired
Example: "Something went wrong"
metaobjectrequired

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/brightdata/year=2024/month=05/day=03/j_lvq47h0g13te1b3wpu.e7b0795e7affc9953dadd43e6fce99a2c5260043.file_lvq4cfwv17kcb9m4ej.logo_cached.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": {}
}

Account

Manage your account and monitor usage

Operations
Terms
Copyright © Lusha. All rights reserved.