Contents

API reference / Outbound

Sniff a company's competitors and category conversation

POST /api/v1/market/sniff

sniff_market Write MCP tool

Reads the company's website for what it sells and who it competes with (or the phrases people use to look for its kind of product), then reads the last days of Reddit, Hacker News and Bluesky about the company, up to three competitors and the category. Returns the people asking, complaining, comparing or recommending, best first, each with its tags (question, complaint, recommendation, comparison, feature_request, buy_intent, bug_report), a one-line reason and a `noise` flag for bots and promotion. Pass the posts you want to act on to rank_posts. Counts against the plan's daily market sniffs.

A full-access key (ss_sk_…), or an editor or owner signed in.

Request body

JSON, sent with Content-Type: application/json.

NameTypeDescription
company required string
2–60 characters
The company's name.
domain required string
3–300 characters
Its website, e.g. acme.com.
one_liner string
up to 240 characters
What it does, in one line, if its site says little.
days integer
1–30
How far back to read (default 14).

Example

curl -X POST "https://sniffington.com/api/v1/market/sniff" \
  -H "Authorization: Bearer $SCOUT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"company":"…","domain":"…"}'