Count Mentions
count_mentionsCounts mentions that match selected filters and returns only the total, not rows, so you can size dashboards or triage batches and decide whether paging is worthwhile.
Instructions
Count mentions matching the same filters as list_mentions, returning { total } and no rows. The same defaults apply: REJECTED excluded unless statuses includes it, and scores below the website's minimum (30 by default) hidden unless includeLowRelevance is true. Use it for dashboards, to size a triage batch, or to decide whether paging list_mentions is worthwhile; list_mentions already returns total with its rows, so skip this when you fetch rows anyway. Takes no sort, limit, or offset.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "count_mentions"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| to | No | Only mentions RedReplier saved at or before this ISO 8601 datetime (ingestion time, not the post date). Omit for no upper bound | |
| from | No | Only mentions RedReplier saved at or after this ISO 8601 datetime (ingestion time, not the post date). Omit for no lower bound | |
| sources | No | Which networks the conversations come from. Reddit splits into posts and comments, TWITTER is X, FACEBOOK is public pages and profiles, and FACEBOOK_GROUP is posts inside Facebook groups. Omit for every network | |
| keywords | No | Keyword texts whose mentions to count: the value field of a keyword in list_websites or get_website, not its id. Each must match the whole keyword, ignoring case. Omit for every keyword | |
| minScore | No | Relevance score a mention needs to be included, e.g. 70 for strong leads only. Setting it also drops mentions that have no score yet. It adds to the website's own minimum score rather than replacing it, so pair it with includeLowRelevance to look below that. Omit for no extra cutoff | |
| statuses | No | Which triage states to include. NEW means nobody has reviewed the mention yet, APPROVED means someone marked it a real lead, REJECTED means someone marked it noise. Omit to see new and approved mentions; rejected ones show only when you ask for them | |
| websiteId | No | Website whose mentions to read, by its id from list_websites. Omit to cover every website in the workspace | |
| workspaceId | No | Workspace to act in: an id from list_workspaces. Omit to use the default workspace. Use the same workspaceId for every call about the same workspace, since ids from one workspace do not exist in another | |
| scoreBuckets | No | Score bands to include, combined with OR. Each band covers a range of the 0-100 relevance score: VERY_LOW under 10, LOW 10-29, MEDIUM 30-49, HIGH 50-74, VERY_HIGH 75 and up. Omit for every band. The two lowest bands return rows only with includeLowRelevance set | |
| includeLowRelevance | No | Also include mentions scoring below the website's minimum score (30 by default). Omit or false to hide them |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |