Contents

API reference / Competitors

Brief on a competitor

GET /api/v1/competitors/{competitor}/brief

competitor_brief Read MCP tool

A one-page summary of the last `days` (default 30) from posts already judged: volume against the period before, complaints, people looking for an alternative, pricing talk, praise, hiring and what they published. Every claim is followed by the posts behind it. Returns Markdown and the ids cited.

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

Parameters

NameTypeDescription
competitor required
path
string The competitor's id.
days
query
integer
1–365

Example

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