get · mentions:read
Retrieve a mention
Full text plus AI classification for one mention.
Read onlyIdempotent
REST
get
/api/v1/mentions/{id}curl "https://herculradar.com/api/v1/mentions/:id" \ --header "Authorization: Bearer hr_live_…"
MCP
Tool name get_mention. It takes the same input and returns the same { data, meta } envelope as REST, because both call the same function.
Fetch one mention in full, with its AI classification and a link to the original post.
Parameters
| idrequired | string | Mention id |
Response
{
"data": {
"id": "7b0f1e3a-1c4d-4a0a-9f2b-2f4a8c1d0e11",
"source": "reddit",
"url": "https://reddit.com/r/SaaS/comments/abc123",
"author_handle": "ops_kate",
"text": "Our analytics bill tripled. Anyone know a cheaper alternative?",
"published_at": "2026-09-01T09:14:00.000Z",
"engagement": {
"upvotes": 128,
"comments": 41
},
"is_relevant": true,
"category": "complaint",
"sentiment": "negative",
"urgency": 72,
"ai_summary": "User is priced out of a competitor and asking for alternatives.",
"status": "new"
},
"meta": {
"capability": "get_mention",
"requestId": "req_9f2b4a8c1d0e",
"idempotencyReplayed": false,
"docs": "https://herculradar.com/docs/reference/get_mention"
}
}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.