Quickstart

1. Create an API key

Go to clipping.cc/account, open API keys and click create key. The secret (ck_live_…) is shown only once — copy it and store it somewhere safe. If you lose it, revoke it and create another.

The key carries access to your account and draws from your balance. Treat it like a password: never expose it in frontend code or public repositories.

2. Make sure you have balance

Every call draws from the balance of the account that owns the key. With no balance, the API responds 402 Payment Required. Add coins at clipping.cc/balance. See billing for pricing.

3. Make your first call

Verify the key by calling /v1/accounts/me:

curl https://api.clipping.cc/v1/accounts/me \
  -H "Authorization: Bearer ck_live_YOUR_SECRET"

const res = await fetch("https://api.clipping.cc/v1/accounts/me", {
  headers: { Authorization: "Bearer ck_live_YOUR_SECRET" },
});
const me = await res.json();
console.log(me);

import requests

res = requests.get(
    "https://api.clipping.cc/v1/accounts/me",
    headers={"Authorization": "Bearer ck_live_YOUR_SECRET"},
)
print(res.json())

Response:

{
  "account": {
    "user_id": "…",
    "balance_microcoins": 1000000,
    "balance_coins": 1.0,
    "withdrawable_coins": 1.0
  }
}

4. Explore

# your items
curl https://api.clipping.cc/v1/items \
  -H "Authorization: Bearer ck_live_YOUR_SECRET"

# semantic search over your library
curl "https://api.clipping.cc/v1/search?q=artificial%20intelligence" \
  -H "Authorization: Bearer ck_live_YOUR_SECRET"

See every endpoint in the API Reference tab (top menu).

Next steps

Core concepts

The data model — items, collections, reporters, workflows, executions.

Asynchronous operations

How writes return 202 + an execution, and how to track them.

Monitor a source

Add a channel, sync it, list its videos.

Build a reporter

A workflow that analyzes sources automatically.

Get started

Core concepts

Guides

1. Create an API key

2. Make sure you have balance

3. Make your first call

4. Explore

Next steps

Core concepts

Asynchronous operations

Monitor a source

Build a reporter

​1. Create an API key

​2. Make sure you have balance

​3. Make your first call

​4. Explore

​Next steps

Core concepts

Asynchronous operations

Monitor a source

Build a reporter

1. Create an API key

2. Make sure you have balance

3. Make your first call

4. Explore

Next steps