---
title: "Reel dashboard payload (used by /analytics/reels)."
method: GET
path: "/api/v1/analytics/reels"
tags: ["Analytics"]
---

# Reel dashboard payload (used by /analytics/reels).

`GET /api/v1/analytics/reels`

## 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/analytics/reels`
- Auth: one of:
  - API key in cookie `session`
  - HTTP bearer

<br/>Scoped to the caller: regular users see only reels they own (plus<br/>aggregates over the same set); admins see the platform-wide view.

## Query parameters

- `sort_by` string
- `account` string
- `category_id` integer, nullable
- `tag` string
- `min_views` integer
- `min_engagement` number
- `min_vph` integer
- `days` integer
- `min_followers` integer
- `max_followers` integer
- `favorites_only` boolean

## Response `200`

OK

- ReelDashboardResponse
  - `accounts` string[]
  - `active_accounts_count` integer
  - `all_tags` TagCount[]
    - `count` integer, required
    - `tag` string, required
  - `categories` CategoryRow[]
    - `color` string, nullable
    - `id` integer, required
    - `name` string, required
  - `reels` ReelRow[]
    - `account_followers` integer, nullable, required
    - `account_username` string, nullable, required
    - `caption` string, required
    - `comments` integer, nullable, required
    - `engagement_rate` number, required
    - `has_script` boolean, required
    - `id` integer, required
    - `is_favorite` boolean, required
    - `last_scanned_at` string, date-time, nullable, required
    - `likes` integer, nullable, required
    - `posted_at` string, date-time, nullable, required
    - `reel_shortcode` string, required
    - `reel_url` string, nullable, required
    - `scan_count` integer, nullable, required
    - `views` integer, nullable, required
    - `views_per_hour` number, required
  - `stats` ReelStatsView
    - `avg_engagement` number
    - `top_reel` TopReel
      - `account` string, nullable, required
      - `url` string, nullable, required
      - `views` integer, nullable, required
    - `total_reels` integer
    - `total_views` integer

## 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)