Contents

API reference / Accounts

Import target accounts (or check what an import would cost)

POST /api/v1/accounts/import

import_accounts Write MCP tool

Add companies to scan, from a list of domains or records (`accounts`), CSV or JSON text (`csv`) or the address of a public list (`url`). A row is a company's own website and, optionally, its name, a one-liner, the lists it came from (`origin`), its competitors and category phrases; the columns can be named domain / website / url, name / company, one_liner / description, origin / source / batch, competitors, phrases. 100 accounts a call; for a longer list pass `csv` or `url` again with `offset` set to next_offset until it is null. The domain is the key, so importing the same list again changes nothing. Nothing is scanned by this call: each account's site is then read once (what it sells, up to three competitors, the phrases people use to look for it; and whether it is a business or a hobby project), and Reddit, Hacker News and Bluesky are scanned for the conversation in its market, in the background. Pass `dry_run: true` to write nothing and get what the import and a first scan of the list would cost in model spend, which accounts the plan would take and how many days of the daily judging allowance it needs. The plan limits how many accounts a workspace holds (402 plan_limit).

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

Request body

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

NameTypeDescription
accounts array of any
up to 100 items
Up to 100 domains (strings) or records: { domain, name, one_liner, origin, competitors, phrases }.
csv string
up to 600000 characters
CSV, TSV or JSON text, or one company a line. With a header row (domain, name, one_liner, origin, competitors, phrases).
url string
up to 300 characters
The address of a public CSV or JSON list to read. Only public addresses are fetched.
offset integer
at least 0
For csv and url: how many rows to skip (the previous call's next_offset).
origin string
up to 40 characters
A name for the list, added to every row's origins (for example yc-fall-2026).
dry_run boolean Write nothing; return the cost estimate and what would be imported.

Returns

{ data: { imported | would, accounts, skipped, total_rows, offset, next_offset, estimate?, limits } }

Example

curl -X POST "https://sniffington.com/api/v1/accounts/import" \
  -H "Authorization: Bearer $SCOUT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"accounts":["…"],"csv":"…"}'