COPS
Brand API

Get share-of-views by age bucket per platform

GET
/analytics/view-share-by-age

Per-video share of first-30-day views landing in each age bucket (Day 0 / Day 1 / Days 2–3 / Days 4–7 / Days 8–30), averaged per platform. Age-based, so it ignores the date range; scopes by org + platform/campaign/creator/account. Backs the home 'Share of views by age' chart.

Authorization

apiKeyAuth
headerx-api-key<token>

API key for authentication. Keys are prefixed with cops_.

Query Parameters

accountScope?string
Value in"campaign""tracked"
creatorIds?array<>
accountIds?array<>
campaignIds?array<>
platforms?array<>
dateRange?
metricFilters?
sortBy?string
Value in"title""platform""accountHandle""viralityMultiplier""views""likes""comments""shares""bookmarks""engagement""publishedAt""updatedAt"
sortOrder?string
Value in"asc""desc"
limit?integer
Range-9007199254740991 <= value <= 9007199254740991
offset?integer
Range0 <= value <= 9007199254740991
showExcluded?boolean

Response Body

Response schema unavailable.

Example Request
curl -X GET 'https://cops.app/api/brand/analytics/view-share-by-age'
Example Response200
Empty

Get platform breakdown GET

Get video count and total views grouped by publish date and platform. Backs the per-platform bar charts and distribution donuts.

Get campaign breakdown GET

Get video count and total views grouped by publish date and campaign. Backs the per-campaign bar chart and distribution donuts.