List mentions

GET /api/v1/mentions

list_mentions Read MCP tool

Filter, search and page through mentions. Cursor-paginated: pass next_cursor back as cursor.

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`
`sentiment` query	array of string	Sentiment. One of: `positive` `negative` `neutral`
`status` query	array of string	Workflow status. One of: `open` `done` `follow_up`
`relevance` query	array of string	Urgency band (high ≥70, medium ≥40). One of: `high` `medium` `low`
`categories` query	array of integer	Category ids.
`keywords` query	array of integer	Keyword ids.
`groups` query	array of integer	Keyword group ids.
`authors` query	array of string	Exact author handles, e.g. @someone or u/someone.
`urgency_min` query	integer 0–100
`urgency_max` query	integer 0–100
`min_engagement` query	integer at least 0
`engagement` query	string	Per-source minimum engagement, e.g. x:10,reddit:5.
`since` query	string	ISO date/time or epoch ms.
`until` query	string	ISO date/time or epoch ms.
`found_since` query	string	Only mentions first collected at or after this ISO date/time or epoch ms, however old the post itself is.
`q` query	string	Full-text search over text, author, place and the AI's summary.
`include` query	string	relevant (default): real mentions. irrelevant: filtered out as namesakes or noise. One of: `relevant` `irrelevant` `all`
`range` query	string	A relative date window; since/until win when both are given. One of: `today` `7d` `30d` `90d` `12m` `all`
`view` query	integer	Apply a saved view's filters.
`order` query	string	found = most recently collected first. One of: `newest` `oldest` `urgency` `engagement` `found`
`limit` query	integer 1–100	Page size (default 25, max 100).
`cursor` query	string	Opaque cursor from a previous page's next_cursor.

Returns

{ data: Mention[], next_cursor, total }

Example

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