Introduction
Read and change your COPS data over a REST API.
COPS has two REST APIs. Each one has its own base URL, its own API keys and its own OpenAPI spec.
| API | For | Base URL | OpenAPI spec |
|---|---|---|---|
| Brand API | Operators who run campaigns in an organization | https://cops.app/api/brand | /api/brand/openapi.json |
| Creator API | A creator's own accounts, videos and earnings | https://cops.app/api/creator | /api/creator/openapi.json |
Authentication
Send your API key in the x-api-key header on every request. Keys start with cops_.
curl https://cops.app/api/brand/campaigns \
-H "x-api-key: cops_..."- A brand key belongs to one organization. Create it in Organization → API keys.
- A creator key belongs to you. Create it in Settings → API keys. Creator keys are available after you join a campaign.
- API keys work only on the REST API. The MCP server uses OAuth instead.
A request with a missing or invalid key gets 401 Unauthorized.
Try a request
Each endpoint page has a playground. Select Try in Playground, enter your key and send the request.