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 groups items into a working set you can share, point reporters at, or expose publicly.

​
1. Create a collection

curl -X POST https://api.clipping.cc/v1/collections \
  -H "Authorization: Bearer ck_live_…" -H "Content-Type: application/json" \
  -d '{ "name": "AI channels", "visibility": "private", "language": "en" }'

​
2. Add sources

Add by URL/handle — the item is created (or reused) and linked in one call: 
curl -X POST https://api.clipping.cc/v1/collections/col_123/items \
  -H "Authorization: Bearer ck_live_…" -H "Content-Type: application/json" \
  -d '{ "source": "https://youtube.com/@channel" }'
Remove with DELETE /v1/collections/{id}/items/{item_id}.

​
3. Read it

GET /v1/collections/{id} returns the collection with its items, attached reporters, subscribers, and a first page of documents. Paginate documents separately with GET /v1/collections/{id}/documents.

​
Visibility & exposure

Set visibility: "public" to list the collection in the public catalog (discover). When public, four expose_* flags control what non-owners actually see — the owner always sees everything:
FlagReveals
expose_channelsthe channel items
expose_contentsnon-channel items (videos, etc.)
expose_reportersreporters attached to / subscribing the collection
expose_documentsthe owner’s documents (summaries)
Set them on create or update: 
curl -X PATCH https://api.clipping.cc/v1/collections/col_123 \
  -H "Authorization: Bearer ck_live_…" -H "Content-Type: application/json" \
  -d '{ "visibility": "public", "expose_channels": true, "expose_documents": true }'
Public + nothing exposed = the collection shows up in the catalog but its contents stay private. Turn flags on deliberately.

​
Next

Charge for a collection

Set a price and let fans subscribe to unlock gated content.