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:

• Person API – retrieve contact data for a business profile
• Company API – retrieve company data based on domain or company name
• Prospecting API – query Lusha’s extensive database based on specific criteria (job title, seniority, industry, and more) to retrieve detailed contact and company information

All API requests must be made over HTTPS (SSL), and responses are delivered in JSON format.

Setting Up the Test Environment

Accessing Lusha's Postman Collection

You can explore Lusha's Postman Workspace to:

• Import the complete Lusha API collection
• Test out pre-configured request examples
• Or find the collection by searching for "Lusha" directly in Postman

This setup allows you to quickly configure, customize, and start working with Lusha’s API endpoints in a sandboxed environment.

Configuring Environment Variables

1. Go to Environments in Postman and create a new environment.
2. Add a variable named API_KEY and set its value to your Lusha API key.
3. Ensure this environment is selected before making any requests.

💡 Note: Access to Lusha’s API key is limited to Scale users or those on an active Scale trial.

Collection Structure

• Contact Enrichment
  • GET Person V2 – Single direct contact enrichment
  • POST Person V2 Bulk – Bulk direct contact enrichment
• Company Enrichment
  • GET Company – Single direct company enrichment
  • POST Company Bulk – Bulk direct company enrichment
• Filters for Prospecting
  • Company – Name/Domain, Industries, Sizes, Revenue, Locations, NAICS, SICs, Intent, Technology
  • Contact – Departments, Seniority, Existing data points, Locations, All countries
• Prospecting
  • Contact Prospecting – Search & Enrich (POST)
  • Company Prospecting – Search & Enrich (POST)
• Credit Usage
  • GET Credit Usage – Check your account’s credit consumption

Accessing Saved Examples

Each endpoint in the Lusha API collection includes pre-saved examples that showcase the request structure, body, parameters, and expected responses. Users can explore these examples to better understand how to format their API requests and interpret responses efficiently.

To access these examples:

1. Select any request in the Lusha API collection.

2. Click on the folder dropdown next to the request name in Postman.

   

3. Choose an example to view the saved request format and response structure.

   

4. Modify the parameters as needed and run the request to see live data.

Best Practices

• Store your API key securely using Postman’s environment variables.
• Use the Save Responses feature to track changes in API output.
• Check the Body tab for response data (JSON with fields like emails, phones, company_info).
• Use the Pretty view for better readability.

Support

If you encounter any issues, refer to Lusha’s API documentation or reach out to our support team via:

• Live chat on the Lusha website or your Dashboard
• Email: support@lusha.com