Skip to content
Last updated

Changelog

All notable changes to the Lusha API/MCP are documented here. We follow semantic versioning.


Current Version: 2.0.0

Status: Production • Released: 2025 • Stability: Stable

API Endpoints

Rate Limits

  • Person enrichment: 25 req/sec
  • Account usage: 5 req/min

Changelog History

## [1.4.0] - 2025-09-30 - Enhanced Search Capabilities

### Added
- **New searchText Filter**: Introduced free-text search capability for Prospecting APIs
  - Available in both `include` and `exclude` sections for contact and company filters
  - `POST /prospecting/contact/search` – Supports searchText in both `contacts` and `companies` filter sections
  - `POST /prospecting/company/search` – Supports searchText in `companies` filter section
  - Enables natural language queries like "finance marketing in Germany DE"
  - Searches across multiple fields simultaneously (names, titles, descriptions, locations)

### Changed
- **Prospecting Search Schemas**: Updated `ContactFilters` and `CompanyFilters` to include optional `searchText` property
  - Contact filters: Can search/exclude across contact names, titles, and related text fields
  - Company filters: Can search/exclude across company names, descriptions, and locations

### Notes
- The searchText filter provides a more flexible and intuitive way to search the Prospecting database
- Supports complex queries combining multiple criteria in a single text string
- Can be combined with existing structured filters for more precise targeting
- Both positive (include) and negative (exclude) text filtering is supported

## [1.3.0] - 2025-09-10 - Signals API Expansion

### Added
- **New Signals Endpoints**: Introduced 4 endpoints for contact and company signals, supporting enrichment by IDs and identifiers:
  - `POST /signals/contacts` – Retrieve contact signals by IDs
  - `POST /signals/companies` – Retrieve company signals by IDs
  - `POST /signals/contacts/search` – Retrieve contact signals by identifiers (LinkedIn URL, email, or name + company/domain)
  - `POST /signals/companies/search` – Retrieve company signals by identifiers (domain, company name, or ID)
- **Signals Filters Endpoint**:
  - `GET /signals/filters/:objectType` – View available signal filters for `contact` or `company`
  - `allFilters` option available to view all signals
- **Timeframe Filtering**: All signal endpoints support `start_date` (optional) with default range of last 6 months
- **Partial Profile Filter**: Added `partialProfile` boolean parameter to contact enrichment APIs for simplified contact profiles

### Changed
- **Enrichment APIs**: Expanded `v2/person` (single & bulk) and `v2/company` (single & bulk) to always return `person_id` and `company_id` where applicable
- **Signal Filters Usage**: Existing enrichment APIs can now leverage signals as filters

### Notes
- The new Signals suite allows deeper insights into contact and company activity
- Timeframe filtering provides flexibility while defaulting to recent (6 months) signals
- Partial profiles provide a lightweight option for basic contact information retrieval

Format

## [Version] - YYYY-MM-DD

### Added
- New features and endpoints

### Changed  
- Updates to existing functionality

### Fixed
- Bug fixes and corrections

### Removed
- Deprecated features

### Security
- Security improvements

Notifications


API Versioning

VersionStatusSupport Level
2.0.xCurrentFull support
1.xLegacySecurity only

Last updated: September 2025


Last updated: August 2025


Last updated: June 2025


Last updated: December 2024