Developers/Docs/Signals API

Signals API

Access real-time intent signals across 46 industry verticals. Signals represent behavioral intent, transactional activity, and self-declared preferences — never FCRA-regulated data.

Each signal returned by the API includes a source_status field: 'available' (queryable now) or 'fcra_blocked' (permanently excluded under FCRA). Filter on source_status = 'available' to only query signals with live coverage.

Signal Categories

Category	Description	Example
switching_intent	Vendor dissatisfaction or active evaluation	Comparing CRM alternatives
bant_qualified	Budget, Authority, Need, Timeline confirmed	RFP issued with budget range
funding_ma	Funding round or M&A activity	Series B announcement
topic_surge	Abnormal research activity on a topic	3x increase in cybersecurity research
permit_filed	Government permit or license filed	Commercial building permit
tech_install	New technology adoption detected	Salesforce implementation

Signal Availability

Every signal object in the API response includes a source_status field. Valid values are:

Value	Meaning
'available'	Signal is collected and queryable.
'fcra_blocked'	Signal is permanently excluded. Contains or derives from FCRA-regulated attributes (e.g. credit, employment, rental history). No buyer certification unlocks these.

Query Signals

GET/api/v1/signals

Query Parameters

Parameter	Type	Description
category	string	Signal category filter
industry	string	Industry vertical
intent_level	string	hot, warm, or cold
state	string	Two-letter state code
since	ISO 8601	Only signals after this timestamp
limit	integer	Results per page (default 25, max 100)

bash

curl "https://api.siedata.dev/api/v1/signals?category=switching_intent&industry=saas&intent_level=hot" \
  -H "X-API-Key: vpx_live_YOUR_KEY"

Intent Levels

HOT

Active buyer with budget, timeline, and vendor evaluation underway. Premium tier pricing.

WARM

Research phase with timeline or vendor named. Standard tier pricing.

COLD

Early interest signal. Contact with interest indicator only. Basic tier pricing.

Batch Signal Query

POST/api/v1/signals/batch

Query multiple signal categories and geographies in a single request.

json

{
  "queries": [
    { "category": "switching_intent", "industry": "saas", "state": "CA" },
    { "category": "permit_filed", "industry": "home-services", "state": "TX" }
  ],
  "limit_per_query": 25
}

Signal Stream (SSE)

GET/api/v1/signals/stream

Subscribe to a real-time server-sent events (SSE) stream for new signals matching your filters. Requires a Full Access key.

javascript

const source = new EventSource(
  "https://api.siedata.dev/api/v1/signals/stream?category=switching_intent",
  { headers: { "X-API-Key": "vpx_full_YOUR_KEY" } }
);

source.onmessage = (event) => {
  const signal = JSON.parse(event.data);
  console.log("New signal:", signal);
};