> ## Documentation Index
> Fetch the complete documentation index at: https://docs.clipstake.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Creator API

> Submit your Instagram and X posts as clips from your own tools.

The Creator API is for creators who submit many clips. Your own tools can
list your campaigns and accounts, submit clips, and follow the clips you
submitted.

ClipStake turns the API on for your account and chooses the campaigns that
your API key can submit to. A new account can submit to no campaigns.

> [card] [Quickstart](https://docs.clipstake.com/creator-api/quickstart.md)
>
> Connect your accounts and submit your first clip.

> [card] [Authentication](https://docs.clipstake.com/creator-api/authentication.md)
>
> Create, send and revoke API keys.

## What you can do

| Endpoint | What it does |
| - | - |
| `GET /campaigns` | Lists the campaigns that your API key can submit to. |
| `GET /accounts` | Lists the Instagram and X accounts that you connected. |
| `GET /accounts/{account_id}/media` | Lists the recent videos of one Instagram account. |
| `POST /clips` | Submits a post to a campaign as a clip. |
| `GET /campaigns/{campaign_id}/clips` | Lists the clips that you submitted to a campaign. |

## Base URL

```text theme={null}
https://app.clipstake.com/api/v1/creator
```

## IDs

Each ID starts with a prefix that names its resource.

| Prefix | Resource |
| - | - |
| `cmp_` | Campaign |
| `acct_` | Instagram or X account |
| `clip_` | Clip |

An ID that your API key cannot use returns `404`. This includes a campaign
that ClipStake did not open to your key, an account that is not yours and an
ID with the wrong prefix.

## Rules that still apply

The API runs the same checks as the ClipStake app. A campaign refuses a clip
when, for example:

* The campaign is not live.
* The campaign is invite-only and you did not accept the invite. Accept it in
  the ClipStake app.
* The post was published before the campaign started, or outside its time
  limit.
* The campaign pays by viewer country and Instagram did not report the
  countries of your account's viewers.
* You reached the number of clips the campaign allows.

A refused clip returns `422 submission_refused`. The message tells you why.

## Money

* Amounts are integers in US cents. For example, `42500` is \$425.00.
* Rates are what you earn for 1,000 views, before the platform fee.
* `platform_fee_bps` on a campaign is its platform fee, in basis points.
  `1500` is 15%. A campaign keeps the same fee for its whole life.
* `paid_cents` on a clip is what ClipStake paid to you for it so far, after
  the fee.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.