COPS
Brand API

Track account

POST
/accounts/track

Start tracking one or more social accounts by profile URL for your organization. Auto-links them to the default campaign; optionally pass a campaignId or creatorId to link on creation. Fetches profile + recent videos in the background and returns which URLs were accepted vs. failed.

Authorization

apiKeyAuth
headerx-api-key<token>

API key for authentication. Keys are prefixed with cops_.

Request Body

application/json
  1. body
accounts*array<>
Items1 <= items <= 2500
campaignId?string
Match^prj_.+[\s\S]*$
creatorId?string
Match^cre_.+[\s\S]*$

Response Body

Response schema unavailable.

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

Get account by ID GET

Get one social account tracked in your organization, with its metrics. Pass an id from list_accounts.

Refresh account POST

Queue a manual re-fetch of one account's latest profile data and recent videos from its platform. Runs in the background; poll the account's scrapeStatus for progress. Pass an accountId from list_accounts.