Contents

API reference / Accounts

List target accounts

GET /api/v1/accounts

list_accounts Read MCP tool

The companies this workspace wants to write to (see import_accounts), each with its conversation summary under the workspace's playbook for target accounts (the built-in gtm one when none is applied): `conversations.ready` is how many posts are worth acting on now (a real person asking, switching or complaining in the account's market in the last 7 to 14 days, not answered yet), `best_score`, `freshest_days` and how many posts still wait for the AI. Filter by origin (the list it came from), status, company type, `has_conversation` (at least one ready post) and `fresh_days`; the best first by default. Reading costs nothing. `overview` counts the whole workspace; `limits` and `paid` say what the plan allows and the budget for X and LinkedIn.

Any API key or OAuth token, or a signed-in member.

Parameters

NameTypeDescription
q
query
string Words in the name, domain or one-liner.
origin
query
string Only accounts that came from this list (a YC batch, a VC portfolio, a CSV name).
status
query
string new = its site is not read yet, ready = read and scanned on schedule, paused.
One of: new ready paused
company_type
query
string business, hobby (a hobby, student or consumer project) or unknown (not typed yet).
One of: business hobby unknown
has_conversation
query
boolean Only accounts with at least one conversation worth acting on now.
fresh_days
query
integer
1–14
Only accounts with a kept post newer than this many days.
order
query
string best (default: the strongest conversation first), name, newest (imported), scanned, freshest.
One of: best name newest scanned freshest
playbook
query
string A playbook id to decide what is worth acting on, instead of the workspace's.
limit
query
integer
1–100
Page size (default 25, max 100).
offset
query
integer
at least 0
How many accounts to skip (next_offset from the last page).

Returns

{ data: Account[], total, next_offset, playbook, origins, overview, limits, paid }

Example

curl "https://sniffington.com/api/v1/accounts" \
  -H "Authorization: Bearer $SCOUT_API_KEY"