COPS
Brand API

Get video metrics timeline

GET
/analytics/video-timeline

Get aggregated video engagement metrics over time as a daily series (views, likes, comments, shares, bookmarks, engagement). No spend or cost figures.

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/video-timeline'
Example Response200
Empty

Get CPM by creator GET

Effective cost per 1,000 views (paid ÷ views × 1000) per creator. Backs the CPM-by-creator ranked bar chart.

Get video metric totals GET

Get aggregated totals for video engagement metrics (views, likes, comments, shares, bookmarks) plus videoCount, across the filter context. No spend or cost figures.