COPS
Brand API

List accounts

GET
/accounts

List the social accounts tracked in your organization, each with metrics (followers, views, video counts) and links to their creator and campaigns. Supports offset/limit paging and filters. Use a returned account id with get_account or as an accountIds filter elsewhere.

Authorization

apiKeyAuth
headerx-api-key<token>

API key for authentication. Keys are prefixed with cops_.

Query Parameters

creatorIds?array<>
accountIds?array<>
campaignIds?array<>
platforms?array<>
dateRange?
metricFilters?
sortBy?string
Value in"handle""name""platform""scrapeStatus""postHealth""viewHealth""followers""totalViews""totalLikes""totalComments""totalShares""totalBookmarks""totalVideos""engagement""createdAt""lastScrapedAt"
sortOrder?string
Value in"asc""desc"
limit?integer
Range-9007199254740991 <= value <= 9007199254740991
tracked?boolean

Response Body

Response schema unavailable.

Example Request
curl -X GET 'https://cops.app/api/brand/accounts'
Example Response200
Empty

Update creator org metadata PATCH

Update a creator's organization-specific metadata: status ('active' or 'inactive' within your organization), notes, and tags. The status is a label: it never starts or stops account syncing (use set_accounts_status for that). Only the fields you pass change. This never touches the creator's shared profile — use update_creator for that. Pass an id from list_creators.

Get account by ID GET

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