Organize with collections

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:

Flag	Reveals
`expose_channels`	the channel items
`expose_contents`	non-channel items (videos, etc.)
`expose_reporters`	reporters attached to / subscribing the collection
`expose_documents`	the 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.

Charge for a collection

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

Get started

Core concepts

Guides

Organize with collections

1. Create a collection

2. Add sources

3. Read it

Visibility & exposure

Next

Charge for a collection

​1. Create a collection

​2. Add sources

​3. Read it

​Visibility & exposure

​Next

Charge for a collection

1. Create a collection

2. Add sources

3. Read it

Visibility & exposure

Next