List target accounts
GET /api/v1/accounts
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
| Name | Type | Description |
|---|---|---|
qquery |
string | Words in the name, domain or one-liner. |
originquery |
string | Only accounts that came from this list (a YC batch, a VC portfolio, a CSV name). |
statusquery |
string | new = its site is not read yet, ready = read and scanned on schedule, paused. One of: new ready paused |
company_typequery |
string | business, hobby (a hobby, student or consumer project) or unknown (not typed yet). One of: business hobby unknown |
has_conversationquery |
boolean | Only accounts with at least one conversation worth acting on now. |
fresh_daysquery |
integer 1–14 |
Only accounts with a kept post newer than this many days. |
orderquery |
string | best (default: the strongest conversation first), name, newest (imported), scanned, freshest. One of: best name newest scanned freshest |
playbookquery |
string | A playbook id to decide what is worth acting on, instead of the workspace's. |
limitquery |
integer 1–100 |
Page size (default 25, max 100). |
offsetquery |
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"