---
title: "Get creator metrics history"
method: GET
path: "/creators/{id}/metrics"
tags: ["Creators"]
---

# Get creator metrics history

`GET /creators/{id}/metrics`

## Request

- Base URL: `https://viral.app/api/v1`
- URL: `https://viral.app/api/v1/creators/{id}/metrics`
- Auth: API key in header `x-api-key`

Retrieves the selected metrics as a time series aggregated into day, week, or month buckets across every account assigned to the creator. Content metrics are per-bucket gains summed over the accounts; follower/following add up each account's latest known level.

## Path parameters

- `id` string, required: Organization creator ID with orgcre_ prefix

## Query parameters

- `metrics` string[], required
- `aggregation` 'day' | 'week' | 'month'

## Response `200`

OK

- object: Creator metrics with only the requested metric series populated in each returned bucket. Content metrics sum the creator's accounts' per-bucket gains; follower/following sum the accounts' latest known levels.
  - `aggregation` 'day' | 'week' | 'month', required
  - `dailyMetrics` object[], required
    - `date` string, required: Bucket start date in ISO format (YYYY-MM-DD)
    - `endDate` string, required: Bucket end date in ISO format (YYYY-MM-DD)
    - `viewCount` number
    - `organicViewCount` number
    - `paidViewCount` number
    - `likeCount` number
    - `commentCount` number
    - `shareCount` number
    - `bookmarkCount` number
    - `engagementRate` number
    - `postCount` number
    - `followerCount` number
    - `followingCount` number

## Other responses

- `400`: 400
- `401`: 401
- `402`: 402
- `404`: 404
- `408`: 408
- `429`: 429
- `500`: 500

---

[API](https://skmtc.dev/viral/apis/viral-app-api.md) · [All operations](https://skmtc.dev/viral/apis/viral-app-api/llms.txt) · [OpenAPI document](https://skmtc.dev/viral/apis/viral-app-api/revisions/31e97fa79ef1?raw)