Pular para o conteúdo principal

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.

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:
FlagRevela
expose_channelsos items de canal
expose_contentsitems não-canal (vídeos, etc.)
expose_reportersreporters anexados / que assinam a coleção
expose_documentsos 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.

​
Próximo

Cobrar por uma coleção

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