Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.clipping.cc/llms.txt

Use this file to discover all available pages before exploring further.

​
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/me: 
curl https://api.clipping.cc/v1/me \
  -H "Authorization: Bearer ck_live_YOUR_SECRET"
Response: 
{
  "user_id": "…",
  "key_id": "…",
  "balance_microcoins": 1000000,
  "balance_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).