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.
A:
- All requests must be made over HTTPS (SSL).
- Responses are returned in JSON format.
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.
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.
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.
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.
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." } **
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.
A:
Yes, the API allows up to 25 requests per second per endpoint to ensure fair usage and system stability.
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.
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.
A:
Yes, you can test API calls using the example requests provided in the documentation or with tools like Postman, using your API key.