Company Signals

Retrieve signal events for a list of companies - hiring activity, headcount changes, web traffic, IT spend, news, and intent.

Pass up to 100 company ids. Use signalTypes to specify which signals to return (or use allSignals). Optionally set a startDate to limit results to recent activity.

Intent signals

Four signal types track week-over-week changes in what a company is researching:

newIntentTopic - a topic with no activity the previous week now has a score
intentScoreIncrease - the topic’s score went up compared to the previous week
intentScoreDecrease - the topic’s score went down compared to the previous week
intentTopicRemoved - the topic dropped below the activity threshold, so it no longer has a score

Scores run from 0 to 100 - a high score means the company is researching the topic more than usual. Data refreshes weekly.

allSignals does not include the intent types - name them in signalTypes. Narrow them with filters.include.intentTopics (find exact names with Get Company Signal Filter Values and filterType=intentTopics) and filters.include.intentCategories. Every topic in the catalog is available - the topics selected in your dashboard don’t apply.

Billing: Charged per matched signal per result via the showSignalsCompany action. Intent signals are charged the same way as every other company signal - no matches, no charge.

Persisting to a table: Pass tableId to also add these companies to an existing table and populate the Signals column. See Companies Tables.

POST

companies

signals

curl --request POST \
  --url https://api.lusha.com/v3/companies/signals \
  --header 'Content-Type: application/json' \
  --header 'api_key: <api-key>' \
  --data '
{
  "ids": [
    "16303253"
  ],
  "signalTypes": [
    "allSignals"
  ],
  "startDate": "2025-01-01",
  "maxResultsPerSignal": 10
}
'

{
  "results": [
    {
      "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
        }
      ]
    },
    {
      "id": "99999999",
      "error": {
        "code": "NOT_FOUND",
        "message": "Company not found"
      }
    }
  ],
  "billing": {
    "creditsCharged": 3,
    "resultsReturned": 1
  }
}

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

ids

string[]

required

Required array length: 1 - 100 elements

Example:

["16303253"]

signalTypes

enum<string>[]

required

Signal types to retrieve. allSignals returns every company signal type except the four intent types (newIntentTopic, intentScoreIncrease, intentScoreDecrease, intentTopicRemoved) - name those explicitly to get them.

Available options:

allSignals,

linkedinActivityIntent,

newIntentTopic,

intentScoreIncrease,

intentScoreDecrease,

intentTopicRemoved,

websiteTrafficDecrease,

websiteTrafficIncrease,

itSpendIncrease,

itSpendDecrease,

linkedinFollowersIncrease,

linkedinFollowersDecrease,

surgeInHiring,

headcountIncrease1m,

headcountIncrease3m,

headcountIncrease6m,

headcountIncrease12m,

headcountDecrease1m,

headcountDecrease3m,

headcountDecrease6m,

headcountDecrease12m,

surgeInHiringByDepartment,

surgeInHiringByLocation,

riskNews,

commercialActivityNews,

corporateStrategyNews,

financialEventsNews,

peopleNews,

marketIntelligenceNews,

productActivityNews

Example:

["allSignals"]

startDate

string<date>

For linkedinActivityIntent, results are limited to a trailing 90-day window regardless of the value passed (legal requirement). Other signal types are unaffected.

Example:

"2025-01-01"

maxResultsPerSignal

integer

For linkedinActivityIntent, results are capped at 50 per company regardless of the value passed. Other signal types use the requested value as-is (1-100). For the intent types, the cap applies after intentTopics / intentCategories filtering.

Required range: 1 <= x <= 100

Example:

10

tableId

string

Optional. If provided, these companies are also added to this table (if not already present) and the Signals column is populated. See the Tables API.

Example:

"583021"

filters

object

Show child attributes

Response

Successful response

results

object[]

Show child attributes

startDate

string

endDate

string

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.

Show child attributes

billing

object

Credit usage summary for a V3 API request

Show child attributes

requestId

string<uuid>

Request ID, for support and tracing

⌘I

curl --request POST \
  --url https://api.lusha.com/v3/companies/signals \
  --header 'Content-Type: application/json' \
  --header 'api_key: <api-key>' \
  --data '
{
  "ids": [
    "16303253"
  ],
  "signalTypes": [
    "allSignals"
  ],
  "startDate": "2025-01-01",
  "maxResultsPerSignal": 10
}
'

{
  "results": [
    {
      "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
        }
      ]
    },
    {
      "id": "99999999",
      "error": {
        "code": "NOT_FOUND",
        "message": "Company not found"
      }
    }
  ],
  "billing": {
    "creditsCharged": 3,
    "resultsReturned": 1
  }
}

Overview

Resources

Endpoints

Company Signals

Intent signals

Authorizations

Body

Response