Contents

API reference / Mentions

Today's brief

GET /api/v1/brief

get_brief Read MCP tool

What needs a person today: open mentions ranked by urgency, each with the AI's one-line reason, how many are open per project and how many arrived in the last 24 hours. Start here when asked what people are saying about a brand.

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

Parameters

NameTypeDescription
project
query
string Only this project.
limit
query
integer
1–50
How many mentions to return (default 10).

Returns

{ data: { open, new_24h, projects: [{ id, name, open }], mentions: Mention[] } }

Example

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