Skip to main content
GET
List Signals

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

brand_id
integer
required

Query Parameters

scope
enum<string> | null

Slice granularity the signal was detected on: account (whole brand), account_platform (brand on one AI platform), topic, or topic_platform.

Available options:
account,
account_platform,
topic,
topic_platform
platform
string | null

AI platform the signal was detected on (e.g. OpenAI). Multi-platform signals carry the (multi) sentinel; the response slice.platforms lists the real platforms.

metric
string | null

Metric the signal fired on. Known values: presence_rate, position_top_rate, cited_domain_rate (new metrics may be added).

alert_type
enum<string> | null

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

Available options:
level_change,
trend
direction
enum<string> | null

Direction of the movement: up, down, or none.

Available options:
up,
down,
none
tier
enum<string> | null

Confidence tier. When omitted, only the default user-facing tiers are returned (high, confident, worth_a_look, provisional); pass an explicit tier to see a single tier, including the noise-floor tiers (low_confidence, underpowered, untested).

Available options:
high,
confident,
worth_a_look,
provisional,
low_confidence,
underpowered,
untested
subject_kind
enum<string> | null

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

Available options:
brand,
competitor
anchor_from
string<date> | null

Earliest detected_for_date to include (inclusive, YYYY-MM-DD).

anchor_to
string<date> | null

Latest detected_for_date to include (inclusive, YYYY-MM-DD).

fingerprint
string | null

Only signals with this stable identity (fingerprint). A fingerprint survives nightly re-detections and direction flips of the same underlying issue, so filtering on one — with a wide anchor_from — tracks how that issue evolved after remediation. Combine with direction to separate the original movement from its recovery.

Required string length: 1 - 128
mover_url
string | null

Case-insensitive substring matched against the URLs in the signal's url_movers evidence (per-URL citation movers, emitted for cited_domain_rate signals). Only signals with at least one matching mover URL are returned; signals without URL movers never match.

Required string length: 1 - 2048
sort
enum<string>
default:score_desc

Sort order: score_desc (engine priority, default), delta_desc (largest absolute change first), or detected_desc (newest first).

Available options:
score_desc,
delta_desc,
detected_desc
limit
integer
default:50

Maximum number of signals to return.

Required range: 1 <= x <= 200
offset
integer
default:0

Number of signals to skip (pagination).

Required range: x >= 0

Response

Successful Response

total
integer
required
items
APISignal · object[]
required
offset
integer
default:0
limit
integer | null
metadata
TimeSeriesMetadata · object | null