---
title: "List view used by /followed-accounts."
method: GET
path: "/api/v1/followed-accounts"
tags: ["Followed Accounts"]
---

# List view used by /followed-accounts.

`GET /api/v1/followed-accounts`

## Request

- Base URL: `https://api.avatarfactory.io` (the document declares no server; this is the origin it was published from)
- URL: `https://api.avatarfactory.io/api/v1/followed-accounts`
- Auth: one of:
  - API key in cookie `session`
  - HTTP bearer

<br/>Regular users see their own accounts plus every system account (the<br/>AvatarFactory Verified AI personas and the real influencers we track for<br/>everyone). Admins see the same; Discovered accounts stay on their own<br/>admin route. `AccountCategory` is a global taxonomy so its rows are<br/>returned unfiltered.<br/><br/>`kind=ai|real` narrows to one kind of creator. The page itself does not<br/>send it (it holds one list and switches tabs over it, so its tab counts<br/>always match the screen); it is here for API callers that want one set.

## Query parameters

- `archived` integer
- `favorites_only` boolean
- `kind` 'ai' | 'real', nullable

## Response `200`

OK

- FollowedAccountsListResponse
  - `archived_count` integer
  - `cat_counts` object
  - `categories` FollowedAccountsCategory[], required
    - `color` string, nullable
    - `id` integer, required
    - `name` string, required
    - `scene_categories` string, nullable
  - `items` FollowedAccountListItem[], required
    - `account_kind` string
    - `account_status` string, nullable
    - `archive_reason` string, nullable
    - `archived` integer
    - `bio` string, nullable
    - `categories` object[]
    - `category` object, nullable
    - `category_id` integer, nullable
    - `channel` string, nullable
    - `created_at` string, nullable
    - `display_name` string, nullable
    - `followers` integer, nullable
    - `following` integer, nullable
    - `growth_pct` number, nullable
    - `id` integer, required
    - `is_favorite` boolean
    - `is_global` boolean
    - `is_shared` boolean
    - `last_posted_at` string, nullable
    - `last_scan_attempt_at` string, nullable
    - `last_scan_depth` string, nullable
    - `last_scan_error` string, nullable
    - `last_scanned_at` string, nullable
    - `next_scan_at` string, nullable
    - `posts_count` integer, nullable
    - `profile_picture_url` string, nullable
    - `scan_cadence` string
    - `script_count` integer
    - `tags` string[]
    - `total_scraped` integer, nullable
    - `username` string, required
  - `reels_indexed_total` integer, nullable
  - `total_accounts` integer
  - `total_categories` integer
  - `uncategorized_count` integer
  - `viewer_is_admin` boolean
  - `viral_radar` ViralRadarUsage: The caller's Viral Radar quota position, for the page-head display. One plan number caps both axes: accounts tracked and account-scans per day (UTC). Omitted (None on the parent) for admins, who bypass quotas.
    - `accounts_used` integer, required
    - `limit` integer, required
    - `scans_used_today` integer, required

## Other responses

- `422`: Unprocessable Entity

---

[API](https://skmtc.dev/avatarfactory/apis/avatarfactory-api.md) · [All operations](https://skmtc.dev/avatarfactory/apis/avatarfactory-api/llms.txt) · [OpenAPI document](https://skmtc.dev/avatarfactory/apis/avatarfactory-api/revisions/66fc7aa3f296?raw)