COPS
Brand API

List accounts

GET
/manager/accounts

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.

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

List creators GET

Returns a cursor-paginated page of creators with rolled-up video metrics plus Cost / CPM / CPE from payouts in the active date range. **Drill chain**: Children of campaigns. Pass `campaignIds` to scope to creators of those campaigns. The returned `id` can be used as a `creatorIds` filter on the Accounts / Videos endpoints. **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 (status, country, gender, metrics). Use `q` for free-text search on name/email. Use `statusIn` as a shortcut to filter by creator status; it takes precedence over a `status` entry in `filter`.

List videos GET

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.