Skip to main content
The Prospecting API lets you query Lusha’s extensive B2B database using filters that match your Ideal Customer Profile - job title, seniority, location, industry, company size, and more. Unlike the Enrichment API, which fills in data on records you already know, Prospecting generates entirely new records you can load directly into your CRM.

​
How prospecting works

The process runs in three ordered steps: choose your filters, run a search to get matching IDs, then enrich those IDs to retrieve full contact or company data.
1

Choose your filters

Use the Contact Filters or Company Filters endpoints to retrieve the valid values for each filter field - departments, seniority levels, industry labels, company sizes, locations, and more. Always look up filter values before building a search request; passing an unrecognized value will return no results.
2

Search

POST your filter criteria to /prospecting/contact/search or /prospecting/company/search. The response returns a list of matching record IDs and basic metadata. No credits are consumed at this step.
3

Enrich

POST the IDs from your search results to /prospecting/contact/enrich or /prospecting/company/enrich to retrieve full records - verified emails, phone numbers, job details, firmographics, and more. Credits are charged at the enrich step.

​
Prospecting flows

See Search Contacts and Enrich Contacts for full details.

​
Premium and plan-specific features

Signal filtering is a premium feature available on select plans. When you filter by signal type (such as promotion or companyChange), credits are charged for each signal type that returns results. See Search Contacts and Search Companies for signal filter syntax.
DNC filtering is a Scale plan feature. Pass "excludeDnc": true at the top level of any contact search request to exclude contacts whose phone numbers are all marked Do Not Call. Contacts with at least one callable number remain in results, and only callable phones are returned. Calling this parameter on an unsupported plan returns a 403 error.

​
Filter reference

Both filter categories expose dedicated endpoints for discovering valid values before you search.

Contact Filters

Look up departments, seniority levels, data points, countries, and locations for contact searches.

Company Filters

Look up industries, sizes, revenues, locations, SIC/NAICS codes, intent topics, and technologies for company searches.