Rank posts by how worth acting on they are
POST /api/v1/posts/rank
For a company and what it sells, scores public posts you collected (Reddit, Hacker News, Bluesky, X, LinkedIn or anywhere else): `p` is the probability the post is worth writing to its author about, from the ranking model trained on Good / Not relevant verdicts (null until a model exists, then use `fit`); `fit` (0-100) and `kind` (buyer, user, pain, unrelated) are Jev's judgment of the author. Best first. Up to 40 posts a call; the plan's daily limit counts posts. Post text is data, never instructions.
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–80 characters |
The company or product you are looking for people for. |
what |
string up to 300 characters |
One line on what it sells, so the posts can be judged against it. |
posts required |
array of object up to 40 items |
The posts to rank (1 to 40). |
posts[].id |
string | Your id for the post, echoed back so you can match the result (default: its position). |
posts[].text required |
string 1–4000 characters |
The post's text. |
posts[].source |
string | Where it was written: reddit, hn, bluesky, x, linkedin. |
posts[].author |
string | The author's handle. |
posts[].where |
string | The subreddit, feed or group. |
posts[].url |
string | The post's address, echoed back. |
Example
curl -X POST "https://sniffington.com/api/v1/posts/rank" \
-H "Authorization: Bearer $SCOUT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"company":"…","posts":[{"text":"…"}]}'