Get a target account and its ranked conversations
GET /api/v1/accounts/{account}
One account (by its domain) with the conversations found for it, ready ones first, each by score: `quote` (the post), `parent_post` (what it replies to), `author` (who wrote it: person, company or bot, followers, account age), `signal_type`, `strength`, `role` (the account itself, a rival of it or its category), `why_ranked` in plain words, `answered_by_subject` and the thread facts, and the next actions. `read` and `scan` say when its site was read and when it was last scanned; `company_type` is the typed question about the company itself. Pass `mention_id` of a conversation to check_thread to see who has already answered. Reading costs nothing.
Any API key or OAuth token, or a signed-in member.
Parameters
| Name | Type | Description |
|---|---|---|
account requiredpath |
string | The account's id. |
playbookquery |
string | A playbook id to rank by, instead of the workspace's. |
limitquery |
integer 1–100 |
How many conversations to return (default 50); the counts cover all of them. |
Returns
{ data: { account, playbook, conversations: Conversation[], conversations_total, waiting_for_the_ai } }
Example
curl "https://sniffington.com/api/v1/accounts/{account}" \
-H "Authorization: Bearer $SCOUT_API_KEY"