Sniff a company's competitors and category conversation
POST /api/v1/market/sniff
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.
| Name | Type | Description |
|---|---|---|
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":"…"}'