get · mentions:read
Mention analytics
Counts for one window: totals, relevance rate, how many need attention, and breakdowns by category, sentiment, source and status. Answers "how are we doing" without paging the feed.
Read onlyIdempotent
REST
get
/api/v1/analytics/mentionscurl "https://herculradar.com/api/v1/analytics/mentions" \ --header "Authorization: Bearer hr_live_…"
MCP
Tool name get_mention_analytics. It takes the same input and returns the same { data, meta } envelope as REST, because both call the same function.
Counts for a window — totals, relevance rate, how many need attention, and breakdowns by category, sentiment and source. Use this to answer "how are we doing" without paging the whole feed.
Parameters
| date_preset | today | last_24_hours | last_7_days | last_30_days | last_90_days | month_to_date | all_time | Named window (default last_30_days) |
| monitor_id | string | Restrict to one monitor |
Response
{
"data": {
"window": "last_30_days",
"total": 412,
"relevant": 268,
"relevance_rate": 0.65,
"needs_attention": 9,
"by_category": {
"complaint": 91,
"product_idea": 74,
"testimonial": 62,
"bug_report": 28,
"other": 13
},
"by_sentiment": {
"negative": 121,
"neutral": 96,
"positive": 51
},
"by_source": {
"reddit": 180,
"x": 154,
"youtube": 78
},
"by_status": {
"new": 203,
"reviewed": 41,
"done": 24
}
},
"meta": {
"capability": "get_mention_analytics",
"requestId": "req_9f2b4a8c1d0e",
"idempotencyReplayed": false,
"docs": "https://herculradar.com/docs/reference/get_mention_analytics"
}
}Authorization
Requires the mentions:read scope. A credential without it gets 403 FORBIDDEN. Resources in projects the credential cannot reach answer 404 NOT_FOUND rather than 403, so ids cannot be probed across tenants.