Skip to main content
POST
Prospecting Companies
Prospecting Companies searches Lusha’s company database for accounts that match your target market: size, revenue range, industry, sub-industry, technologies, locations, SIC/NAICS codes, buyer intent topics, and signal activity. The response is a page of lightweight company previews - not full firmographic records. Each preview includes an id. Pass that id to Enrich Companies to get the full company profile.
Prospect, then enrich

Endpoint

Authentication: API key (api_key header) Results are paginated up to 50,000 total.

Request body

object
required
Pagination controls.
object
required
object
required
object
required
Criteria that matching companies must satisfy.
object
Same fields as include. Companies matching this criteria are removed from results. Example: { "domains": ["competitor.com"] }
object
Use the Company filter types and Company filter values endpoints to look up valid values (industry IDs, SIC/NAICS codes, intent topics, and more) before building a request.

Example request


Response

200 - Success

string
Unique ID for this search.
object
page, size, and total (total matching companies across all pages).
object[]
Array of company previews.
object
creditsCharged and resultsReturned for this request.
Billing: Prospecting is charged per result via the api_search action. If you filter by signals, an additional charge applies per matched signal per result.

Error codes

Authorizations

api_key
string
header
required

Your Lusha API key. You can find this in your Lusha dashboard under API settings. Include this key in the api_key header for all requests.

Body

application/json
pagination
object
required
filters
object
required

filters.contacts cannot be combined with company searchText, signals, intent, or technologies on the same request - doing so returns 400 (contact filters are never silently ignored).

tableId
string

Optional. If provided, results are also persisted to this table. See the Tables API.

Example:

"583021"

options
object

Response

Successful response

requestId
string<uuid>
results
object[]
pagination
object
tableWrite
object

Added to a Prospecting, Enrich, Signals, or Lookalike response when tableId is passed on the request. The primary response is unaffected even if the table write fails.

billing
object

Credit usage summary for a V3 API request