Creator Hub Analytics

Get Creator Hub campaign performance table

Returns paginated per-campaign comparison rows for the selected scope: assigned and posting creators, posted videos against the period-prorated target, campaign views (views gained while a creator is assigned) and their share across every campaign in scope, paid + projected payouts with effective CPM and spend per video in the display currency, plus engagement and virality metrics.

get/creator-hub/overview/campaign-performance

Request

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

Query parameters

pagenumber

Page number (1-based index)

Example:1
perPagenumber

Number of items per page (1-100)

Example:10
sortCol'campaignName' | 'activeCreators' | 'totalPosts' | 'totalVideosEligible' | 'totalViews' | 'viewShare' | 'payoutTotal' | 'effectiveCpm' | 'spendPerVideo' | 'engagementRate' | 'viralityRate'
sortDir'asc' | 'desc'
scope'dateRange' | 'allTime'
fromstring required

Start date in ISO format (YYYY-MM-DD)

tostring required

End date in ISO format (YYYY-MM-DD)

{
  "from": "2025-01-01",
  "to": "2025-01-31"
}
campaignIdsstring[] 
[
  "orgcamp_RwmraAffhMt9"
]
creatorIdsstring[]
publicationMode'allEligible' | 'onlyPublished'

Response

OK

currencystring required

Display currency for monetary row values (single-campaign scope: the campaign currency; otherwise the organization default currency, with campaign currencies converted at nearest-date FX rates)

eligibilityRefreshedAtstring nullable required
pageCountnumber required

Total number of pages

totalRowsnumber required

Total number of rows

Example response

{
  "data": [
    {
      "id": "orgcamp_RwmraAffhMt9",
      "campaign": {
        "id": "orgcamp_RwmraAffhMt9",
        "status": "active"
      }
    }
  ],
  "resolvedRange": {
    "from": "2025-01-01",
    "to": "2025-01-31"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.