Import target accounts (or check what an import would cost)
POST /api/v1/accounts/import
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.
| Name | Type | Description |
|---|---|---|
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":"…"}'