Contents

API reference / Accounts

Scan a target account now

POST /api/v1/accounts/{account}/scan

scan_account Write MCP tool

Asks for the account's site to be read (if it has not been) and its market scanned at the next turn of the workspace's background work, within a minute or two, instead of waiting for the daily scan. Reddit, Hacker News and Bluesky cost nothing; only posts not seen before are judged, once. A scan asked for again within a few minutes of the last one is refused (queued: false). The result appears in get_account.

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

Parameters

NameTypeDescription
account required
path
string The account's id.

Returns

{ data: { id, queued, reason? } }

Example

curl -X POST "https://sniffington.com/api/v1/accounts/{account}/scan" \
  -H "Authorization: Bearer $SCOUT_API_KEY"