COPS
Brand API

List videos

GET
/manager/videos

Returns a cursor-paginated page of individual videos. Each row carries the video's duration and a viralityMultiplier (this video's views ÷ the publishing account's median views — > 1 means above-average performance).

Drill chain: Leaves of the campaign → creator → account → video chain. Pass any combination of campaignIds, creatorIds, accountIds to scope.

Pagination: cursor-based. Use nextCursor to fetch the next page. Set limit: 0 for a count-only request.

Filtering: pass a filter array for structured constraints (views, engagement, duration, availability). Use q for free-text search on title/handle.

Authorization

apiKeyAuth
headerx-api-key<token>

API key for authentication. Keys are prefixed with cops_.

Query Parameters

cursor?|

Opaque pagination cursor returned in nextCursor from the previous page. Pass null (or omit) for the first page. Cursors are tied to the active sort + filters and become invalid if those change.

limit?integer

Page size, 0–200. Use 0 to skip row materialization and return only totalCount (useful for tab badges / count-only requests). Default 100.

Range0 <= value <= 200
Default100
dateRange?
platforms?array<>
campaignIds?array<|unknown>
creatorIds?array<>
accountIds?array<>
showExcluded?boolean
sort?string

Single-column sort. Format: <columnId> for ascending, -<columnId> for descending (e.g. -engagementRate, views, -publishedAt). Allowed columnIds match the entity's sort keys; invalid keys are ignored.

Lengthlength <= 60
q?string

Free-text search. Per-entity semantics: matches name/description for campaigns, name/email for creators, handle/name for accounts, title/handle for videos.

Lengthlength <= 200
includeColumns?array<>

Column ids the caller intends to render. When supplied, columns not listed may be skipped for performance and return as null, unless they're sorted or filtered. Unknown ids are silently ignored.

Itemsitems <= 100
filter?array<>

Filter constraints. Each entry is { columnId, variant, operator, value? }. Supported operators per variant: number/date accept gt/gte/lt/lte/between + isEmpty/isNotEmpty; multi-select accepts isAnyOf/isNoneOf + isEmpty/isNotEmpty; boolean accepts isTrue/isFalse + isEmpty/isNotEmpty; text accepts is/isNot/contains + isEmpty/isNotEmpty. Invalid pairs are silently dropped.

Itemsitems <= 40

Response Body

Response schema unavailable.

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

List accounts GET

Returns a cursor-paginated page of social accounts (a creator's TikTok / Instagram / etc. handle) with rolled-up video metrics. **Drill chain**: Children of creators (and grandchildren of campaigns). Pass `campaignIds` and/or `creatorIds` to scope. The returned `id` can be used as an `accountIds` filter on the Videos endpoint. **Pagination**: cursor-based. Use `nextCursor` to fetch the next page. Set `limit: 0` for a count-only request. **Filtering**: pass a `filter` array for structured constraints (followers, engagement, account status, scrape health). Use `q` for free-text search on handle/name. **TikTok Ads readiness**: TikTok rows include last-synced org-scoped Business Center readiness fields: `tiktokAdsLinkStatus`, identity metadata, `tiktokAdsAvailableStatus`, `tiktokAdsCanPullVideo`, `tiktokAdsSyncedAt`, and `tiktokAdsLinkReason`. These fields are not realtime ownership proof. **Meta partnership ads**: Instagram rows include last-synced org-scoped partnership-permission fields: `metaAdsLinkStatus` (linked/pending/not_linked/revoked/unknown), `metaAdsPermissionId`, `metaAdsCreatorUsername`, `metaAdsSyncedAt`, and `metaAdsLinkReason`. These fields are not realtime ownership proof.

List manager views GET

List personal and organization-shared manager views. Personal defaults override organization defaults.