Mention analytics

GET /api/v1/analytics

get_analytics Read MCP tool

Totals, mentions over time with the sentiment split, and the mix by source, category, keyword and group, plus the weekday × hour heatmap and top supporters and critics – one call.

Any API key or OAuth token, or a signed-in member.

Parameters

Name	Type	Description
`project` query	string	Project id.
`sources` query	array of string	Sources to search. Omit for every source available. One of: `reddit` `linkedin` `x` `hn` `instagram` `github` `stackoverflow` `devto` `bluesky` `news` `youtube` `tiktok` `threads`
`groups` query	array of integer	Keyword group ids.
`keywords` query	array of integer	Keyword ids.
`categories` query	array of integer	Category ids.
`sentiment` query	array of string	Sentiment. One of: `positive` `negative` `neutral`
`since` query	string	ISO date/time or epoch ms.
`until` query	string	ISO date/time or epoch ms.
`include` query	string	relevant (default): real mentions. irrelevant: filtered out as namesakes or noise. One of: `relevant` `irrelevant` `all`

Example

curl "https://sniffington.com/api/v1/analytics" \
  -H "Authorization: Bearer $SCOUT_API_KEY"