Signals

Signals are time-based events detected by AI agents that affect your entities. They represent an immutable audit trail of what happened and when—funding rounds, leadership changes, hiring events, product launches, and more.

Overview

Signals help you stay informed about important business changes:

Funding announcements and capital raises
Leadership and executive changes
Company news and press releases
Job postings and hiring activity
Product launches and expansions
Acquisitions and partnerships

Read-Only Resource

Signals are generated automatically by Linkt's monitoring workflows. The API provides read-only access—signals cannot be created, modified, or deleted via the API. They are created exclusively by AI agents during task execution.

Signal Structure

{
  "id": "507f1f77bcf86cd799439020",
  "icp_id": "507f1f77bcf86cd799439011",
  "entity_ids": ["507f1f77bcf86cd799439015", "507f1f77bcf86cd799439016"],
  "summary": "Acme Corp announced $50M Series B funding led by Sequoia Capital, bringing total funding to $75M.",
  "signal_type": "funding",
  "signal_display_name": "Funding & Budget Events",
  "strength": "HIGH",
  "references": ["https://techcrunch.com/2025/01/15/acme-series-b"],
  "created_at": "2025-01-15T10:30:00Z"
}

Fields

Field	Type	Description
`id`	string	Unique signal identifier
`icp_id`	string	ICP that defines what this signal means—signals are owned by ICPs
`entity_ids`	array	Entity IDs this signal relates to (may be empty for topic-based signals)
`summary`	string	AI-generated explanation of what happened
`signal_type`	string	Category of signal (see Signal Types below)
`signal_display_name`	string	Human-readable display name (optional)
`strength`	string	Signal importance: `LOW`, `MEDIUM`, or `HIGH`
`references`	array	Source URLs where this information was found
`created_at`	datetime	When the signal was detected

Signal Types

Linkt detects 17 types of business signals including funding rounds, leadership changes, acquisitions, hiring surges, RFPs, and more.

Signal Types Reference

For detailed information on all 17 signal types—including triggers, examples, sales implications, and best practices—see the Signal Types Reference.

Signal Strength

Each signal includes a strength indicator showing its potential impact:

Strength	Meaning	Recommended Action
`HIGH`	Significant event, strong sales trigger	Immediate outreach
`MEDIUM`	Notable event, worth monitoring	Time your engagement
`LOW`	Minor event, background context	Note for future reference

See the Signal Types Reference for detailed strength interpretation guidelines.

Entity Relationships

Signals are linked to entities through the entity_ids array. A single signal can be associated with multiple entities:

{
  "signal_type": "acquisition",
  "entity_ids": ["acquiring_company_id", "acquired_company_id"],
  "summary": "Acme Corp announced acquisition of StartupXYZ for $100M"
}

Topic-Based Signals

The entity_ids array can be empty for topic-based signals. These signals track events across your monitored topics without being tied to specific entities in your sheets.

Querying Signals

List Signals

Retrieve signals with filtering and pagination:

curl -X GET "https://api.linkt.ai/v1/signal?signal_type=funding&strength=HIGH&days=30" \
  -H "x-api-key: your-api-key"

Query Parameters

Parameter	Type	Default	Description
`icp_id`	string	—	Filter by specific ICP
`entity_id`	string	—	Filter by entity (matches entity_ids array)
`signal_type`	string	—	Filter by signal type (e.g., `funding`)
`strength`	string	—	Filter by strength: `LOW`, `MEDIUM`, `HIGH`
`search_term`	string	—	Search in summary or signal_type (case-insensitive)
`days`	integer	30	Number of days to look back (1-90)
`page`	integer	1	Page number
`page_size`	integer	20	Results per page (1-100)
`sort_by`	string	—	Sort field: `created_at`, `updated_at`, `signal_type`, `strength`
`order`	integer	-1	Sort order: -1 (descending), 1 (ascending)

Response Format

{
  "signals": [
    {
      "id": "507f1f77bcf86cd799439020",
      "icp_id": "507f1f77bcf86cd799439011",
      "entity_ids": ["507f1f77bcf86cd799439015"],
      "summary": "Acme Corp announced $50M Series B funding...",
      "signal_type": "funding",
      "strength": "HIGH",
      "references": ["https://techcrunch.com/..."],
      "created_at": "2025-01-15T10:30:00Z"
    }
  ],
  "total": 45,
  "page": 1,
  "page_size": 20
}

Get Single Signal

curl -X GET "https://api.linkt.ai/v1/signal/507f1f77bcf86cd799439020" \
  -H "x-api-key: your-api-key"

Generating Signals

Signals are generated through signal monitoring workflows:

Topic monitoring — Track keywords and topics across the web
Sheet monitoring — Monitor existing entities for changes
CSV signals — Generate signals from uploaded data

See Tasks for signal task configuration.

Next Steps

Signal Types Reference — Complete reference for all 17 signal types
Topic Monitoring — Set up topic-based signal monitoring
Account Monitoring — Monitor signals for specific companies
Tasks — Configure signal monitoring workflows
API Reference — Complete signal endpoint documentation

On this page