Skip to main content
POST
Search the mention feed

Authorizations

Authorization
string
header
required

An agent key (rpk_...) created in Settings → API & MCP, sent as Authorization: Bearer rpk_.... Bearer only: a cookie session can never drive this API. An OAuth 2.1 access token obtained from the same host works identically and lands on the same ceiling.

Headers

X-Workspace-Id
string

Which workspace to read. Omit it and you get the account’s home workspace, which on an agency account is often not where the live businesses are. A workspace this credential cannot read is refused with 403 rather than quietly answered from the default.

Body

application/json
page
integer

1-based page number.

pageSize
integer

Rows per page.

business
string

Business id to filter to.

tracker
string

Brand tracker id to filter to.

sort
string

Sort axis, for example newest by post date.

skipFacets
boolean

Skip computing facet counts, which is faster.

filters
object

Platform, sentiment, relevance and date filters.

Response

Success.

The response is of type object.