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 (such as job title, seniority, industry, and more) to retrieve detailed contact and company information.
Setting Up the Test Environment
Click the Run in Postman Button
Click the Run in Postman button provided in the API documentation (this will automatically import the Lusha API collection and configure example requests) or access Lusha’s API collection directly from Postman.
Configuring Environment Variables
Go to Environments in Postman and create a new environment.
Add a variable named
API_KEYand set its value to your Lusha API key.Ensure this environment is selected before making requests.
💡 Note: Access to Lusha’s API key is limited to Scale users or those on an active Scale trial.
Collection Structure
Once imported, the Lusha API collection is structured as follows:
Contact Enrichment
GETPerson V2 - Single direct contact enrichmentPOSTPerson V2 Bulk - Bulk direct contact enrichment
Company Enrichment
GETCompany - Single direct company enrichmentPOSTCompany 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
POSTCompany Prospecting - Search & Enrich
POST
Credit Usage
GETCredit Usage - Check your account’s credit consumption
Accessing Saved Examples
Each endpoint in the 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 Test Environment.
2. Click on the folder dropdown (found next to the request name in Postman).
3. Choose an example to view the saved request format and response structure.
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.
The response will be in JSON format with fields such as
emails,phones, andcompany_info.Use the Pretty view for better readability.
By following this guide, you should be able to check and test Lusha's API using Postman efficiently.
If you encounter any issues, refer to Lusha’s API documentation or contact the support team via live chat from the Lusha website, your Lusha Dashboard, or via email- support@lusha.com.
If you encounter any issues, refer to Lusha’s API documentation or reach out to support for assistance.