Skip to main content
GET
List signals

Authorizations

Authorization
string
header
required

A workspace API key, created in workspace settings and sent as Authorization: Bearer op_live_…. Session cookies are not accepted. Scopes: signals:read, accounts:read, listeners:read, listeners:analyse, pipeline:read, pipeline:write, collections:write, export:read.

Query Parameters

listenerId
string

Only signals from this listener.

limit
integer
default:50

Page size, 1–200. Defaults to 50. Values outside the range are clamped rather than rejected.

Required range: 1 <= x <= 200
cursor
string

nextCursor from the previous page. An unreadable cursor is ignored and the first page is returned, so check nextCursor for null rather than looping until a page comes back empty.

maxAgeDays
integer

Only signals published within this many days. Defaults to the workspace's retention window, and cannot be used to read further back than it.

Required range: x >= 1
classification
enum<string>

Intent label. Valid values depend on the listener's mode, and one from the wrong mode returns an empty page rather than an error — which reads as "nothing found" and is not. Pass listenerId too when you know the mode.

Available options:
high_intent,
evaluating,
relevant,
competitor,
content,
strong_match,
worth_a_look,
stretch,
mismatch,
stale,
hiring_now,
expanding,
replacing,
adjacent,
switching,
frustrated,
comparing,
praise,
pain_confirmed,
at_risk,
healthy,
noise
source
string

Platform the signal came from.

theme
string

Only signals carrying this theme.

q
string

Free-text search over the signal's title and summary. Matches whole words, with stemming: report finds reporting, repo does not. Truncated past 120 characters.

Maximum string length: 120

Response

Signals newest first by postedAt, within the retention window.

One page of signals, newest or strongest first depending on the endpoint.

items
object[]
required

Up to limit signals.

nextCursor
string | null
required

Pass as cursor to fetch the next page. null on the last page — which is the only reliable way to know you have reached it, since a full page can still be the last one.