Skip to main content

What it does

Lusha Prospect finds people or companies you don’t already have by filtering Lusha’s database — by department, seniority, location, company size, revenue, industry, technologies, and intent. It returns cheap, non-PII previews (name, title, company, location) plus each match’s id and a canReveal list showing which data points exist and what they cost. Hand those ids to Lusha Enrich to reveal contact details only for the matches worth contacting.
Requires Lusha Integration: Set up the Lusha integration before agents can use this tool.

Key features

  • Filter-based discovery over Lusha’s full B2B database (top of funnel — find the names)
  • Person filters: department, seniority, country/location, required data points
  • Company filters: size, revenue, location, industry, NAICS/SIC, technologies, intent topics
  • Returns non-PII previews — no reveal credits spent on discovery
  • Paginate up to 50,000 results per query
  • Each match includes an id ready to pass to Lusha Enrich

Parameters

*At least one of contact_filters / company_filters is required. A contact search can filter on company attributes too — pass both.

Common use cases

Find decision-makers at target-sized companies

Returns C-suite and VP finance leaders at 51–200 employee companies, as previews.

Build a target-account list

Returns Texas construction companies above $10M revenue.

Page through a large result set

Repeat with increasing page until you’ve collected enough matches.

What you get back

  • results[] — each preview includes id, name, jobTitle, company, location, has (available fields), and canReveal ([{ field, credits }])
  • total_matches — total number of records matching the filters
  • page / size — the page returned
  • rate_limits — remaining requests for the minute/hour/day window

Best practices

  • Prospect first, enrich second — discovery is cheap; only spend reveal credits on the subset worth contacting
  • Start broad, then narrow — overly specific filters can return zero matches
  • Use canReveal to see whether a match even has an email/phone before enriching
  • Page deliberately — each page is a request that counts against rate limits

Troubleshooting

“Provide at least one of contact_filters / company_filters”
  • Pass a non-empty filter object — see the keys in the Parameters table
“No results returned”
  • Loosen filters; combining many narrow constraints can eliminate all matches
“Lusha rate limit hit (429)”
  • Slow down or wait for the window to reset — limits vary by plan
  • Lusha Enrich — reveal emails, phones, and firmographics for the ids returned here