# Clipping.Zone

> A two-sided marketplace connecting brands (buyers) and independent clippers (sellers). Brands fund a campaign at a rate per 1,000 verified views with a hard budget cap. Clippers cut the brand's source content, post it to their own accounts, and earn as verified views accrue — until the cap.

Clipping.Zone is the marketplace. It is not the brand, not the employer of clippers, and not an advertising agency. Clippers are independent; they post from their own accounts.

## Platform fee

Brands pay a 5% platform fee on campaign spend (the budget cap). The clipper-facing rate per 1,000 verified views is paid in full — the fee is not taken out of that rate.

Example: budget cap $10,000 at $1.80 / 1K → clippers earn $1.80 / 1K; the brand funds $10,000 + $500 fee = $10,500.

## Pilot

Clip verification is human during the pilot (a brand via this API, or the marketplace operator). There is no view-scraping bot. New campaigns start as `draft` and are not listed publicly until the brand funds them through Stripe Checkout (`POST /api/v1/campaigns/{id}/checkout`). Until `STRIPE_SECRET_KEY` is a test-mode key, that endpoint returns 503 — there is no payment-link fallback.

## Agent path (no email inbox)

An agent acting for a brand does not need a magic-link email. Register, store the API key, create a draft campaign.

1. Read this file and the OpenAPI spec at https://clipping.zone/openapi.json
2. POST https://clipping.zone/api/v1/brands with a JSON body `{ "company_name": "Your Brand" }`
3. Store the returned `api_key` (`cz_live_…`). It is shown once.
4. Call authenticated endpoints with `Authorization: Bearer cz_live_…`

Optional: `contact_name`, `email` on register. Email is contact-only and is not required.

Humans who prefer a browser start at https://clipping.zone/launch — magic link opens the brand studio at https://clipping.zone/brand.

## Auth

`Authorization: Bearer cz_live_<secret>`

Do not put the key in query strings. Issue additional keys at POST /api/v1/api-keys.

## Endpoints

Base URL: https://clipping.zone

| Method | Path | Auth | What |
| --- | --- | --- | --- |
| GET | /llms.txt | no | This document |
| GET | /.well-known/llms.txt | no | Same document |
| GET | /openapi.json | no | OpenAPI 3.1 |
| GET | /api/v1 | no | API index |
| POST | /api/v1/brands | no | Register brand + issue API key |
| GET | /api/v1/me | yes | Authenticated brand |
| POST | /api/v1/api-keys | yes | Issue another key |
| POST | /api/v1/campaigns | yes | Create a **draft** campaign |
| GET | /api/v1/campaigns | yes | List this brand's campaigns |
| GET | /api/v1/campaigns/{id} | yes | Get one campaign |
| POST | /api/v1/campaigns/{id}/checkout | yes | Fund a draft (Stripe Checkout). 503 if Stripe is unset |
| GET | /api/v1/campaigns/{id}/submissions | yes | List submissions |
| POST | /api/v1/submissions/{id}/approve | yes | Approve a pending clip |
| POST | /api/v1/submissions/{id}/reject | yes | Reject with a reason code |

### Create campaign body

JSON object. Required: `title`, `eligible_platforms`, and a rate + budget (cents or dollars).

- `brand_name` (optional; defaults to company_name)
- `title`
- `niche` (shown on cards, e.g. "Energy · Lifestyle")
- `rate_per_1k_cents` **or** `rate_per_1k` (dollars, e.g. 1.80)
- `budget_cap_cents` **or** `budget_cap` (dollars, e.g. 10000)
- `brief` / `rules` (markdown; `## Do` / `## Don't` lists render as two columns)
- `source_content_url`
- `eligible_platforms`: subset of tiktok, instagram, youtube, x, facebook, twitch, snapchat, linkedin
- `ends_at`: YYYY-MM-DD or ISO datetime
- `slug` optional; unique, lowercase-hyphenated

The response includes `platform_fee_bps` (500), `platform_fee_cents`, and `brand_total_cents` (cap + fee). Status is always `draft` on create.

### Reject reason codes

off_brief, watermarked, reposted, misleading_caption, account_mismatch, private_or_deleted, ineligible_platform

POST body: `{ "reason": "off_brief" }`. The code is shown to the clipper verbatim.

## Public listings

GET https://clipping.zone/campaigns is HTML for clippers. Only `live` campaigns are open; only `ended` campaigns appear as recently ended. Drafts never appear there.

## Terms

https://clipping.zone/terms — marketplace role, 5% brand-side fee, independent clippers.
https://clipping.zone/privacy

## Support

support@clipping.zone