Lusha API - Frequently Asked Questions (Q&A)
Q: What APIs does Lusha offer?
A: Lusha provides three main RESTful API endpoints:
Person API
Retrieves contact data for a given business profile (e.g., name, email, position, company).Company API
Retrieves company data based on a domain or company name (e.g., firmographic attributes like industry, size, headquarters).Prospecting API
Enables filter-based queries (e.g., job title, seniority, location) to pull detailed contact and company lists for lead generation workflows.
Q: How do I make requests to Lusha’s APIs?
A:
- All requests must be made over HTTPS (SSL).
- Responses are returned in JSON format.
Q: What does the Person API do?
A:
- Fetches individual contact information for business profiles.
- You supply identifying parameters (e.g., name + company, email, or LinkedIn URL), and the API returns structured contact fields such as
firstName,lastName,email,jobTitle, andcompany.
Q: What does the Company API do?
A:
- Returns company-level data when you provide a domain (e.g.,
lusha.com) or a full company name. - The response includes attributes like
companyName,industry,employeeCount,headquartersLocation, and other firmographics.
Q: What is the Prospecting API, and when should I use it?
A:
- Designed for lead generation, this API allows you to define filter criteria (industry, seniority, location, job title, etc.) to generate lists of contacts or companies matching your Ideal Customer Profile (ICP).
- Use it to build outbound prospect lists or enrich CRM data at scale.
Q: What filtering options are available in the Prospecting API?
A: You can filter on attributes such as:
- Job Title (e.g.,
Director of Engineering) - Seniority (e.g.,
VP,C-Suite,Manager) - Location (city, state, country)
- Industry/Sub-industry (e.g.,
Software,Healthcare) - Company Size (employee bands, e.g.,
50–200,200–500)
Filters return paginated results of matching records.
Q: In what format are responses delivered?
A:
- All endpoints return data as JSON payloads.
- Example Person API response snippet:
**{ "firstName": "Jane", "lastName": "Doe", "email": "jane.doe@example.com", "jobTitle": "Director of Engineering", "company": "Acme Inc." } **
Q: How do I authenticate my API requests?
A:
Include your unique API key in the request header as follows:
api_key: YOUR_API_KEY
API keys are obtained from the Lusha dashboard once your account has API access enabled.
Q: Are there any rate limits on API usage?
A:
Yes, the API allows up to 50 requests per second per endpoint to ensure fair usage and system stability.
Q: How are API errors handled?
A:
The API uses standard HTTP status codes to indicate success or failure. Detailed error messages and codes are provided in the response body to aid troubleshooting.
Q: Do I need to pay for API usage?
A:
API usage typically consumes credits from your Lusha account. For example, credits are charged during the enrichment step in the Prospecting API. Please check your plan details for pricing and credit consumption.
Q: Can I test the API before integrating?
A:
Yes, you can test API calls using the example requests provided in the documentation or with tools like Postman, using your API key.