All notable changes to the Lusha API/MCP are documented here. We follow semantic versioning.
Status: Production • Released: 2025 • Stability: Stable
- Person enrichment: 25 req/sec
- Account usage: 5 req/min
## [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## [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- Email: Subscribe for release notifications
- Support: support@lusha.com
| Version | Status | Support Level |
|---|---|---|
| 2.0.x | Current | Full support |
| 1.x | Legacy | Security only |
Last updated: September 2025
Last updated: August 2025
Last updated: June 2025
Last updated: December 2024