---
title: "Get Creator Hub creator activity table"
method: GET
path: "/creator-hub/overview/activity"
tags: ["Creator Hub Analytics"]
---

# Get Creator Hub creator activity table

`GET /creator-hub/overview/activity`

## Request

- Base URL: `https://viral.app/api/v1`
- URL: `https://viral.app/api/v1/creator-hub/overview/activity`
- Auth: API key in header `x-api-key`

Returns paginated creator activity rows with current billing-period progress and pace status, posted-video progress against rounded prorated campaign targets for the requested range, and recent 14-day post activity. Supports pace-based filtering (all, onSchedule, behindSchedule — the latter grouping runningTight and overdue) and defaults to sorting by progress ratio descending.

## Query parameters

- `page` number: Page number (1-based index)
- `perPage` number: Number of items per page (1-100)
- `sortCol` 'creatorName' | 'campaignName' | 'postedVideos' | 'eligibleVideos' | 'targetVideos' | 'progressRatio'
- `sortDir` 'asc' | 'desc'
- `progressFilter` 'all' | 'onSchedule' | 'behindSchedule'
- `scope` 'dateRange' | 'allTime'
- `dateRange` object, required: Date range filter for analytics queries
  - `from` string, required: Start date in ISO format (YYYY-MM-DD)
  - `to` string, required: End date in ISO format (YYYY-MM-DD)
- `campaignIds` string[]
- `creatorIds` string[]
- `publicationMode` 'allEligible' | 'onlyPublished'

## Response `200`

OK

- object
  - `data` object[], required
    - `id` string, required
    - `creatorId` string, required: Organization creator ID with orgcre_ prefix
    - `creator` object, required
      - `id` string, required
      - `name` string, nullable, required
      - `email` string, required
      - `image` string, nullable, required
    - `accounts` object[]
      - `id` string, required
      - `platform` 'facebook' | 'instagram' | 'tiktok' | 'youtube' | 'snapchat', required
      - `platformAccountId` string, required
      - `isCompetitor` boolean
      - `username` string, nullable, required
      - `displayName` string, nullable
      - `analyticsDataRefreshedAt` string, nullable
    - `campaign` object, required
      - `id` string, required: Campaign ID with orgcamp_ prefix
      - `name` string, required
      - `description` string, nullable, required
      - `currency` 'USD' | 'EUR' | 'CHF' | 'GBP' | 'CNY' | 'JPY' | 'KRW' | 'THB' | 'IDR' | 'VND' | 'RUB', required
      - `interval` 'day' | 'week' | 'month', required
      - `intervalCount` integer, required
      - `intervalDayCount` integer, required
      - `videoTarget` integer, required
      - `videoTargetUnit` 'videos' | 'creatives' | 'per_platform': What the video target counts: "videos" (every post on every platform, a cross-post on three platforms counts 3), "creatives" (each video once, its copies on other platforms included) or "per_platform" (a count per platform in videoTargetPlatforms; videoTarget is their sum).
      - `videoTargetPlatforms` object, nullable
      - `billingAnchor` 'fixed' | 'rolling', required
      - `timeZone` string, required
      - `status` 'upcoming' | 'active' | 'closing' | 'ended', required: Campaign lifecycle status derived from validity window. upcoming: validFrom in the future; active: started with no end date; closing: started and has an end date in the present/future; ended: end date is in the past.
      - `validFrom` string, required
      - `validUntil` string, nullable, required
    - `postedVideos` number, required
    - `eligibleVideos` number, required
    - `targetVideos` number, required
    - `progressRatio` number, required
    - `progressPercent` number, required
    - `averagedPostedVideos` number, required
    - `averagedTargetVideos` number, required
    - `averagedProgressRatio` number, required
    - `averagedProgressPercent` number, required
    - `currentPeriod` object, nullable, required
      - `from` string, required
      - `to` string, required
      - `postedVideos` number, required
      - `targetVideos` number, required
      - `paceStatus` 'onSchedule' | 'runningTight' | 'overdue', required
      - `platforms` object[]
        - `platform` 'facebook' | 'instagram' | 'tiktok' | 'youtube' | 'snapchat', required: Social media platform (facebook, instagram, tiktok, youtube, snapchat)
        - `postedVideos` number, required
        - `targetVideos` number, required
        - `paceStatus` 'onSchedule' | 'runningTight' | 'overdue', required
    - `postActivity` object, required
      - `dayCount` unknown, required
      - `days` object[], required
        - `date` string, required
        - `postedVideos` number, required
    - `lastVideo` object, nullable, required
      - `platform` 'facebook' | 'instagram' | 'tiktok' | 'youtube' | 'snapchat', required: Social media platform (facebook, instagram, tiktok, youtube, snapchat)
      - `platformVideoId` string, required: Native platform video id found in the URL of the video
      - `caption` string, nullable, required
      - `thumbnailUrl` string, nullable, required
      - `accountUsername` string, nullable, required
      - `accountDisplayName` string, nullable, required
      - `contentType` 'video' | 'slideshow', nullable, required: Filter by content types (video, slideshow)
      - `publishedDate` string, required
      - `publishedAt` string, nullable, required
  - `resolvedRange` object, required: Date range filter for analytics queries
    - `from` string, required: Start date in ISO format (YYYY-MM-DD)
    - `to` string, required: End date in ISO format (YYYY-MM-DD)
  - `eligibilityRefreshedAt` string, nullable, required
  - `totals` object, required
    - `rowCount` number, required
    - `postedVideos` number, required
    - `eligibleVideos` number, required
    - `targetVideos` number, required
  - `paceCounts` object, required
    - `onSchedule` number, required
    - `behindSchedule` number, required
  - `pageCount` number, required: Total number of pages
  - `totalRows` number, required: Total number of rows

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