Skip to main content
GET
Count signals in a window

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 count this listener's signals.

maxAgeDays
integer

Window in days. Defaults to the workspace's retention.

Required range: x >= 1
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

Counts over the window. source, theme and q narrow these exactly as they narrow the list, so the totals describe the set the list is drawing from. classification deliberately does not apply — it is what byClass counts, and narrowing by it would make every entry report the size of the selected one.

Totals for a window, counted in the database rather than over a page — so the figures describe every signal rather than the ones that fit in one response.

windowDays
integer
required

The window these counts describe.

total
integer
required

Every signal in the window, including noise.

byClass
object
required

Per-classification counts. Sparse: a class with nothing in it is absent rather than 0, and a stored label the current vocabulary no longer names is dropped rather than passed through as a key you cannot label.

bySource
object
required

Per-source counts over the primary classes only, matching the list they sit beside. Sparse, for the same reason byClass is.

unread
integer
required

Signals nobody in the workspace has opened.

highIntent
integer
required

Read off byClass.high_intent.

evaluating
integer
required

Read off byClass.evaluating.

relevant
integer
required

Read off byClass.relevant.

competitor
integer
required

Read off byClass.competitor.

content
integer
required

Read off byClass.content.

noise
integer
required

Read off byClass.noise.

conversations
integer
required

Everything in the mode's primary classes: what the default view shows.

newLast24h
integer
required

First seen in the last 24 hours, which is not the same as published then.

averageScore
integer
required

Mean relevanceScore across the window, rounded.

latestPostedAt
string<date-time>

The most recent publishedAt in the window. Absent when the window is empty.