Sign in
latestOpenAPI 3.1.02026-08-204087139.4 KB

c4fe20c603a3

signals

Get Signal

Fetch one signal by ID, including its full narrative (what happened, why it matters, what to do) when available. Returns 404 for IDs that exist but are not user-facing (non-fired or cluster-child rows) — the same population rule as listSignals.

get/{brand_id}/signals/{signal_id}

Path parameters

brand_idinteger required
signal_idinteger required

Response

Successful Response

idinteger required

Signal ID. Stable within one detection; use for getSignal.

detected_for_datestring date required

Anchor date the nightly detection ran for (YYYY-MM-DD).

fingerprintstring required

Stable identity of the underlying issue across nightly re-detections (hash of the slice + metric). An ongoing signal is re-raised daily under the same fingerprint; reactions are keyed on it.

subject_kind'brand' | 'competitor' required

Whose movement the signal describes: your brand or a competitor.

alert_type'level_change' | 'trend' required

Detection kind: level_change (step shift) or trend (sustained drift).

scope'account' | 'account_platform' | 'topic' | 'topic_platform' required

Slice granularity: account, account_platform, topic, or topic_platform.

metricstring required

Metric the signal fired on (e.g. presence_rate, position_top_rate, cited_domain_rate).

platformstring required

AI platform the signal was detected on. (multi) means the slice spans several platforms — see slice.platforms for the real list.

direction'up' | 'down' | 'none' required

Direction of the movement: up, down, none.

tier'high' | 'confident' | 'worth_a_look' | 'provisional' | 'low_confidence' | 'underpowered' | 'untested' required

Confidence tier, best first: high, confident, worth_a_look, provisional, then noise-floor tiers low_confidence, underpowered, untested (hidden by default).

current_valuenumber required

Metric value over the current window (0-1 rate).

baseline_valuenumber required

Metric value over the baseline window (0-1 rate).

delta_absolutenumber required

current_value - baseline_value (positive = up).

scorenumber nullable

Engine priority score used for the default sort; null for legacy rows.

narrative_whatstring required

One-line headline of what changed.

window_current_startstring date nullable

Start of the current comparison window.

window_current_endstring date nullable

End of the current comparison window.

baseline_definitionstring nullable

Human-readable definition of the baseline window.

created_atstring date-time required

When the signal row was created (UTC).