Retrieve company signals for business events and growth

Company signals give you visibility into what’s happening inside your target accounts - hiring surges, headcount changes, shifts in website traffic and IT spend, news events across seven categories, and changes in the topics a company is researching. One endpoint takes up to 100 Lusha company IDs and the signal types you want, and returns everything that matched - no separate lookup or search step.

Signals are charged per matched signal per result. Request only the signal types you need.

Get company signals

POST https://api.lusha.com/v3/companies/signals

Send 1–100 Lusha company IDs per request along with the signalTypes you want. Use startDate to limit results to signals detected on or after a given date, and maxResultsPerSignal to cap how many instances of each signal type come back per company. Request body

Field	Type	Required	Description
`ids`	array of strings	Yes	Lusha company IDs, 1–100 per request
`signalTypes`	array of strings	Yes	Signal types to retrieve (see full list below)
`startDate`	string	No	Earliest date for signals, in `YYYY-MM-DD` format
`maxResultsPerSignal`	integer	No	Maximum signal instances returned per type per company (1–100)
`filters.include.intentTopics`	array of strings	No	Narrows the four intent signal types to these topics (not `linkedinActivityIntent`) - see Intent signals
`filters.include.intentCategories`	array of strings	No	Narrows `linkedinActivityIntent` and the intent signal types to these categories

Example request

{
  "ids": ["16303253"],
  "signalTypes": ["allSignals"],
  "startDate": "2025-01-01",
  "maxResultsPerSignal": 10
}

Example response

{
  "results": [
    {
      "id": "16303253",
      "companyName": "Lusha",
      "domain": "lusha.com"
    }
  ],
  "startDate": "2025-01-01",
  "endDate": "2025-07-31",
  "billing": {
    "creditsCharged": 3,
    "resultsReturned": 1
  }
}

Every result carries id, companyName, and domain. Whichever signal types you requested and matched appear as additional arrays keyed by that type name (for example surgeInHiring), the same pattern Contact Signals uses for promotion/companyChange.

Available company signal types

Hiring and workforce

Signal type	Description
`allSignals`	All available company signal types, except the four intent signal types
`surgeInHiring`	Overall increase in open job postings
`surgeInHiringByDepartment`	Hiring surge scoped to a specific department
`surgeInHiringByLocation`	Hiring surge scoped to a specific country or state

Headcount trends

Signal type	Description
`headcountIncrease1m`	Employee count increased over 1 month
`headcountDecrease1m`	Employee count decreased over 1 month
`headcountIncrease3m`	Employee count increased over 3 months
`headcountDecrease3m`	Employee count decreased over 3 months
`headcountIncrease6m`	Employee count increased over 6 months
`headcountDecrease6m`	Employee count decreased over 6 months
`headcountIncrease12m`	Employee count increased over 12 months
`headcountDecrease12m`	Employee count decreased over 12 months

Technology and digital presence

Signal type	Description
`websiteTrafficIncrease`	Website traffic growth
`websiteTrafficDecrease`	Website traffic decline
`itSpendIncrease`	IT spending increase
`itSpendDecrease`	IT spending decrease
`linkedinFollowersIncrease`	LinkedIn follower growth
`linkedinFollowersDecrease`	LinkedIn follower decline

News events

Signal type	Description
`riskNews`	Litigation and security news
`commercialActivityNews`	Launches, partnerships, and go-to-market activity
`corporateStrategyNews`	M&A, restructuring, and strategic direction changes
`financialEventsNews`	Funding, IPO, and financial performance events
`peopleNews`	Hiring, layoff, and leadership changes
`marketIntelligenceNews`	Event participation, recognition, and competitor activity
`productActivityNews`	Product launches, development, and integrations

Intent

Signal type	Description
`linkedinActivityIntent`	Employees posted LinkedIn content mapped to an intent category
`newIntentTopic`	The company started researching a topic it had no activity on the previous week
`intentScoreIncrease`	The company’s intent score for a topic went up compared to the previous week
`intentScoreDecrease`	The company’s intent score for a topic went down compared to the previous week
`intentTopicRemoved`	The topic dropped below the activity threshold, so it no longer has a score

allSignals does not include newIntentTopic, intentScoreIncrease, intentScoreDecrease, or intentTopicRemoved - name them in signalTypes to get them.

Call Get Company Signal Types to fetch this list programmatically instead of hardcoding it.

Intent signals

The four intent signal types track week-over-week changes in what a company is researching. Each topic has a score from 0 to 100 - a high score means the company is researching the topic more than usual. Intent data refreshes weekly. Every topic in the catalog is available - the topics selected in your Lusha dashboard don’t apply.

Find the topics you care about

There are about 18,000 intent topics, so search for them by name. query is required (2-256 characters), and up to 50 matches come back. This call is free.

curl --request GET \
  --url 'https://api.lusha.com/v3/companies/signals/filters/intentTopics?query=cloud%20hr' \
  --header 'api_key: YOUR_API_KEY'

{ "values": ["Cloud HR Platform"] }

Request intent signals for those topics

Name the intent types in signalTypes and pass the exact topic names in filters.include.intentTopics. You can also narrow by filters.include.intentCategories. With neither filter, all topics come back, up to maxResultsPerSignal.

{
  "ids": ["15789512"],
  "signalTypes": ["newIntentTopic", "intentScoreIncrease", "intentScoreDecrease", "intentTopicRemoved"],
  "startDate": "2026-09-01",
  "maxResultsPerSignal": 10,
  "filters": {
    "include": {
      "intentTopics": ["Air Cargo", "Cloud HR Platform", "Employee Onboarding Software"]
    }
  }
}

A topic that isn’t in the catalog returns 400 INVALID_FILTER_VALUE, naming the topic. Always use exact names from the topic search.

Each intent signal returns:

Field	Description
`id`	Signal ID
`signalDate`	Week the change was detected
`topic`	Intent topic
`category`	Category the topic belongs to
`score`	Current score, 0-100. `null` for `intentTopicRemoved`
`previousScore`	Score the previous week. `null` for `newIntentTopic` and `intentTopicRemoved`
`changeRatePercent`	Week-over-week change as a percentage, negative for a decrease. `null` for `newIntentTopic` and `intentTopicRemoved`

{
  "id": "15789512",
  "companyName": "UIC Inc",
  "domain": "uicinc.com",
  "intentScoreIncrease": [
    { "id": "2139910966", "signalDate": "2026-09-28", "topic": "Air Cargo", "category": "Other", "score": 65, "previousScore": 60, "changeRatePercent": 8 }
  ],
  "intentScoreDecrease": [
    { "id": "2139504101", "signalDate": "2026-09-28", "topic": "Cloud HR Platform", "category": "HR Tech", "score": 61, "previousScore": 83, "changeRatePercent": -27 }
  ],
  "intentTopicRemoved": [
    { "id": "2139471579", "signalDate": "2026-09-28", "topic": "Employee Onboarding Software", "category": "HR Tech", "score": null, "previousScore": null, "changeRatePercent": null }
  ]
}

Intent signals are charged like every other company signal - per matched signal per result, via showSignalsCompany. No matches, no charge.

Intent signals are available on this lookup only. You can’t use them to find new companies in Prospecting or signal search - for that, use the Prospecting intentTopics filter.

Explore the news, department, location, and intent taxonomy

Two reference endpoints let you explore what values exist for the news, department, location, and intent dimensions behind company signals. They’re useful for populating a picker UI or validating input before you build automations around specific categories.

List available filter types

Call Get Company Signal Filters - GET /v3/companies/signals/filters - to see the available filter types (newsEventTypes, hiringByDepartments, hiringByLocations, intentCategories, intentTopics) and whether each requires a search query.

Fetch values for a specific filter type

Call Get Company Signal Filter Values - GET /v3/companies/signals/filters/{filterType} - for the values themselves. hiringByLocations and intentTopics require a query (2–256 characters); the others don’t.

If you don’t have company IDs yet

Company Signals only accepts Lusha company IDs. If you’re starting from a company name or domain, resolve the company first, then retrieve signals for the returned ID:

Resolve the company

Call Enrich Companies or Search & Enrich Companies to get a Lusha company id.

Retrieve signals for that ID

Pass the id into POST /v3/companies/signals.

Signals overview - the consolidated signals model, credits, and delivery options
Contact signals - retrieve job change and promotion signals for contacts
API reference: Company Signals - full request/response schema

Overview

Resources

Endpoints

Retrieve company signals for business events and growth

Get company signals

Available company signal types

Intent signals

Explore the news, department, location, and intent taxonomy

If you don’t have company IDs yet

​Get company signals

​Available company signal types

​Intent signals

​Explore the news, department, location, and intent taxonomy

​If you don’t have company IDs yet

​Related pages

Get company signals

Available company signal types

Intent signals

Explore the news, department, location, and intent taxonomy

If you don’t have company IDs yet

Related pages