A: Lusha provides four 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.Signals API
Delivers real-time buying intent and market signals directly into your workflows, including job changes, funding updates, technology adoption, company growth indicators, and behavioral buying signals.
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: The Signals API provides real-time market intelligence and buying intent data that helps you time your outreach perfectly. It streams live notifications about prospects showing buying behavior, including:
- Intent signals: Companies actively researching solutions in your category
- Job changes: Key personnel movements and promotions
- Company growth indicators: Headcount changes, hiring spikes
- Funding events: Recent investment rounds and financial updates
- Technology adoption: New tech stack implementations
- Churn risk indicators: Signals that existing customers may be at risk
The API integrates with your existing workflows to automatically trigger actions when relevant signals appear. Use it to prioritize hot leads, personalize outreach, and engage prospects at the optimal moment.
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.