GET · mentions:read

Get mention analytics

Read a five-minute cached analytics snapshot, including keyword-group mention share and top positive and negative authors, for one accessible project using the dashboard's mention filters.

Read only

REST

GET/api/v1/analytics/mentions

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

MCP

Tool name: get_mention_analytics

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

Input

projectIdrequired

string

Project to analyze

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

datePreset

string

Optional dashboard date preset; all_time disables the 30-day default

tzOffsetrequired

integer

Browser timezone offset in minutes, as returned by Date.getTimezoneOffset

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