Organizar com coleções

Uma coleção agrupa items num conjunto de trabalho que você pode compartilhar, apontar reporters, ou expor publicamente.

1. Crie uma coleção

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

2. Adicione fontes

Adicione por URL/handle — o item é criado (ou reusado) e vinculado numa chamada:

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/@canal" }'

Remova com DELETE /v1/collections/{id}/items/{item_id}.

3. Leia a coleção

GET /v1/collections/{id} devolve a coleção com seus items, reporters anexados, assinantes e a primeira página de documents. Pagine os documents à parte com GET /v1/collections/{id}/documents.

Visibilidade & exposição

Defina visibility: "public" pra listar a coleção no catálogo público (discover). Sendo pública, quatro flags expose_* controlam o que não-donos de fato veem — o dono sempre vê tudo:

Flag	Revela
`expose_channels`	os items de canal
`expose_contents`	items não-canal (vídeos, etc.)
`expose_reporters`	reporters anexados / que assinam a coleção
`expose_documents`	os documents do dono (resumos)

Defina na criação ou atualização:

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 }'

Pública + nada exposto = a coleção aparece no catálogo mas o conteúdo fica privado. Ligue as flags de propósito.

Cobrar por uma coleção

Defina um preço e deixe fãs assinarem pra liberar o conteúdo.

Começando

Conceitos

Guias

Organizar com coleções

1. Crie uma coleção

2. Adicione fontes

3. Leia a coleção

Visibilidade & exposição

Próximo

Cobrar por uma coleção

​1. Crie uma coleção

​2. Adicione fontes

​3. Leia a coleção

​Visibilidade & exposição

​Próximo

Cobrar por uma coleção

1. Crie uma coleção

2. Adicione fontes

3. Leia a coleção

Visibilidade & exposição

Próximo