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.

A collection can be paid: the owner (creator) sets a price, and fans pay to unlock the gated content. The payment goes to the creator’s earnings, minus the platform fee.

​
Set a price (creator)

The collection must be public, then set price_coins and a billing_period: 
curl -X PATCH https://api.clipping.cc/v1/collections/col_123 \
  -H "Authorization: Bearer ck_live_…" -H "Content-Type: application/json" \
  -d '{ "visibility": "public", "price_coins": 20, "billing_period": "monthly" }'
billing_periodAccess
oncelifetime — pay once, keep access
monthlyrenews every 30 days (auto-charged)
price_coins: 0 makes it free again (a public collection behaves normally, gated only by the expose_* flags from Collections).

​
Subscribe (fan)

A fan subscribes — this charges the price immediately and grants access: 
curl -X POST https://api.clipping.cc/v1/collections/col_123/subscribe \
  -H "Authorization: Bearer ck_live_…"

{ "subscription": { "subscription_id": "sub_…", "status": "active",
                    "billing_period": "monthly", "price_coins": 20,
                    "expires_at": 1719500000 } }
Possible errors:
StatusWhen
400collection isn’t paid, isn’t public, or you’re the owner
402insufficient balance to pay the price
409you’re already subscribed

​
See your subscriptions

curl https://api.clipping.cc/v1/collections/subscriptions \
  -H "Authorization: Bearer ck_live_…"
For a once subscription expires_at is null (lifetime); for monthly it’s the renewal date. Access to gated content is: owner, or free collection, or an active subscription.