COPS
Brand API

Track videos

POST
/videos/track

Start tracking one or more videos by URL for your organization. Requires a default campaign to be set. Fetches metrics in the background and returns which URLs were accepted vs. failed to parse.

Authorization

apiKeyAuth
headerx-api-key<token>

API key for authentication. Keys are prefixed with cops_.

Request Body

application/json
  1. body
videos*array<>
Items1 <= items <= 500

Response Body

Response schema unavailable.

Example Request
curl -X POST 'https://cops.app/api/brand/videos/track' \  -H 'Content-Type: application/json' \  -d '{  "videos": [    "string"  ]}'
Example Response200
Empty

Get video by ID GET

Get one video tracked in your organization, with its full metrics and engagement data. Pass an id from list_videos.

Refresh video POST

Queue a manual re-fetch of one video's latest metrics from its platform. Runs in the background; the video's metrics update on completion. Pass a videoId from list_videos.