Sign in

v1

latestOpenAPI 3.0.3Proprietary2026-08-0656136286.9 KB
Signals

Company Signals

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

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.

Billing: Charged per matched signal per result via the showSignalsCompany action.

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

post/v3/companies/signals

Request body

idsstring[] required
signalTypesstring[] required
startDatestring date

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

maxResultsPerSignalinteger

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).

tableIdstring

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 request

{
  "ids": [
    "16303253"
  ],
  "signalTypes": [
    "allSignals"
  ],
  "startDate": "2025-01-01",
  "maxResultsPerSignal": 10,
  "tableId": "583021",
  "filters": {
    "include": {
      "intentCategories": [
        "Technology",
        "Business"
      ]
    }
  }
}

Response

Successful response

startDatestring
endDatestring

Example response

{
  "results": [
    {
      "id": "16303253",
      "companyName": "Lusha",
      "domain": "lusha.com",
      "linkedinActivityIntent": [
        {
          "companyId": 16303253,
          "activityPublicationDate": "2026-05-12",
          "signalCategory": "Technology or Stack Discussion",
          "intentTopics": [
            {
              "topic": "Cloud Security",
              "category": "Technology"
            }
          ],
          "author": {
            "id": "4389064624",
            "fullName": "Daniel Turgeman",
            "linkedinUrl": "https://www.linkedin.com/in/daniel-turgeman-49676b161"
          },
          "contactsMentioned": [
            {
              "id": "4389064624",
              "fullName": "Daniel Turgeman",
              "linkedinUrl": "https://www.linkedin.com/in/daniel-turgeman-49676b161"
            }
          ],
          "companiesMentioned": [
            {
              "id": "16303253",
              "name": "Lusha",
              "linkedinUrl": "https://www.linkedin.com/company/lushadata"
            }
          ],
          "activityUrl": "https://www.linkedin.com/feed/update/urn:li:activity:1234567890",
          "activitySummary": "Discusses adopting a new cloud security stack ahead of Q3 rollout.",
          "activityLikes": 42,
          "activityComments": 5,
          "activityShares": 3,
          "activityType": "post"
        }
      ]
    }
  ],
  "tableWrite": {
    "tableId": "482910",
    "added": 3,
    "alreadyPresent": 2,
    "rowsProcessed": 5,
    "rowsCharged": 5
  },
  "billing": {
    "creditsCharged": 3,
    "resultsReturned": 1
  }
}