GET · mentions:read

List mentions

Search and paginate mentions across accessible projects with the same filters as the dashboard, including an exact From author and stored quoted-post context when available.

Read only

REST

GET/api/v1/mentions

curl "https://www.stalkr.ai/api/v1/mentions" \
  --request GET \
  --header "Authorization: Bearer $STALKR_API_KEY"

MCP

Tool name: list_mentions

The MCP tool accepts the same input schema and returns the same structured { data, meta } result as REST.

Input

projectId

string

source

string

fromSource

string

Network for an exact author filter

fromHandle

string

Exact author handle, without or with a leading @

fromName

string

Exact author display name, used when no handle is available

fromProfileUrl

string

Exact author profile URL fallback when no handle is available

keywordId

string

keywordIds

string

keywordGroupIds

string

Comma-separated keyword group IDs; matches keywords currently in any selected group

status

string

sentiment

string

categoryId

string

urgencyMin

number

urgencyMax

number

search

string

engagement

string

dateFrom

string

dateTo

string

sortrequired

string

directionrequired

string

cursor

string

limitrequired

integer

tzOffsetrequired

integer

Authorization

Required scope: mentions:read.

Scope authorization is followed by resource authorization. Project operations check current membership and the minimum role required by the underlying workflow.

Related resources

REST conventions · MCP setup · Errors and limits