Skip to main content
POST

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
companies
object[]
required

List of company identifiers to search for

Required array length: 1 - 100 elements
signals
enum<string>[]
required

Types of signals to retrieve

Available options:
allSignals,
websiteTrafficIncrease,
websiteTrafficDecrease,
itSpendIncrease,
itSpendDecrease,
headcountIncrease1m,
headcountDecrease1m,
headcountIncrease3m,
headcountDecrease3m,
headcountIncrease6m,
headcountDecrease6m,
headcountIncrease12m,
headcountDecrease12m,
surgeInHiring,
surgeInHiringByDepartment,
surgeInHiringByLocation,
riskNews,
commercialActivityNews,
corporateStrategyNews,
financialEventsNews,
peopleNews,
marketIntelligenceNews,
productActivityNews
Example:
startDate
string<date>

Start date for signal retrieval (YYYY-MM-DD format)

Example:

"2025-01-01"

maxResultsPerSignal
integer

Maximum number of signal instances to return per signal type per entity. Optional.

Default behavior when omitted:

  • No startDate provided: all available signals are returned
  • startDate provided: all signals from that date onward are returned
Example:

10

filters
object

Optional filters to narrow signal results.

Response

Company signals search results

companies
object

Map of company IDs to their signals

endDate
string<date>

End date of the signal period

Example:

"2025-07-31"

startDate
string<date>

Start date of the signal period

Example:

"2025-01-01"

creditCharged
integer

Number of credits charged for this request

Example:

3