GET · mentions:read

List mentions

Search and paginate mentions across accessible projects with the same filters as the dashboard.

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

keywordId

string

keywordIds

string

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