Contents

API reference / Competitors

What people say about a competitor

GET /api/v1/competitors/{competitor}

get_competitor Read MCP tool

The competitor, its numbers over `days` (default 30), and the most urgent judged posts about it, each with the AI's one-line reason, sentiment and intent. Filter the posts by `intent`.

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
intent
query
string
One of: complaint praise alternative pricing other
limit
query
integer
1–50

Example

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