Lusha API Documentation

Copy

• Copy for LLM

  Copy page as Markdown for LLMs
• View as Markdown

  Open this page as Markdown
• Open in ChatGPT

  Get insights from ChatGPT
• Open in Claude

  Get insights from Claude
• Connect to Cursor

  Install MCP server on Cursor
• Connect to VS Code

  Install MCP server on VS Code

Enrichment APIs: Search and enrich contacts and companies.

The V3 API uses a search-then-enrich pattern:

1. Search — Find contacts or companies by identifier. Returns previews with non-PII data and a has field listing available data points.
2. Enrich — Reveal full data (emails, phones, firmographics) using IDs from search.

You can also use Search and Enrich to combine both steps in a single call.

Supported identifiers

• Contacts: id, LinkedIn URL, email, or name + company
• Companies: id, name, or domain

Optionally filter results by signal types using the signals parameter (see Signals section).

Billing: Search uses a capture/charge model (api_search). Enrich charges per data point revealed (revealEmail, revealPhone, reveal_company).

Prospecting APIs: Filter-based search for contacts and companies.

Use prospecting to find new records that match your Ideal Customer Profile (ICP). Apply rich filters across:

• Contact attributes: title, seniority, location, signals
• Company attributes: size, revenue, industry, technologies, intent

Results are paginated: up to 1,000 pages x 50 results = 50,000 results per query. Responses use the same ContactPreview and CompanyPreview structures as the search endpoints.

Billing: Uses the capture/charge model with api_search actions. Signal charges apply additionally.

Lookalike APIs: Use AI-powered recommendations to discover contacts and companies similar to your best existing customers. The Contact Lookalikes and Company Lookalikes endpoints return paginated results you can pipe directly into Enrich for full data.

Real-world activity data for contacts and companies.

Signals are available as standalone endpoints or as an optional signals filter on Search and Prospecting endpoints.

Contact signal types: promotion, companyChange, allSignals

Company signal types: headcountIncrease1m/3m/6m/12m, headcountDecrease1m/3m/6m/12m, surgeInHiring, surgeInHiringByDepartment, surgeInHiringByLocation, websiteTrafficIncrease, websiteTrafficDecrease, itSpendIncrease, itSpendDecrease, riskNews, commercialActivityNews, corporateStrategyNews, financialEventsNews, peopleNews, marketIntelligenceNews, productActivityNews, allSignals

Credits are charged per matched signal per result via showSignalsContact or showSignalsCompany.

Subscribe to real-time notifications when contacts change jobs or companies experience key business events.

Webhooks deliver HTTP POST requests to your endpoints when signals occur - from promotions and job changes to company growth.

For a full list of available signals, refer to Signal Options.

Key Features:

• Real-time contact & company signal notifications
• Bulk subscription management (up to 25 items per request)
• Secure delivery with HMAC-SHA256 signatures
• Delivery monitoring with audit logs

Available Endpoints:

Webhook Delivery Acknowledgment: When receiving webhook deliveries (POST requests), your endpoint must acknowledge with a specific response format. See the Create Subscription endpoint for the required acknowledgment structure.

const crypto = require('crypto');

function verifySignature(payload, signature, timestamp, secret) {
  const signedPayload = `${timestamp}.${JSON.stringify(payload)}`;
  const expectedSignature = crypto
    .createHmac('sha256', secret)
    .update(signedPayload)
    .digest('hex');
  
  return crypto.timingSafeEqual(
    Buffer.from(signature),
    Buffer.from(expectedSignature)
  );
}

{
  "statusCode": 400,
  "message": "Validation failed",
  "errors": ["entityType must be one of: contact, company"]
}

Account API: Retrieve account usage, credit balance, rate limits, plan details, and pricing.

Use this endpoint to monitor consumption and understand the credit cost of each action type in the public API flow.

Rate limit: 5 requests per minute.