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.

O ponto de partida de tudo é um item — uma fonte que você quer monitorar.

​
1. Adicione o item

Mande uma URL ou handle. A API resolve e cria o item (idempotente por fonte — re-postar a mesma fonte devolve o item existente): 
curl -X POST https://api.clipping.cc/v1/items \
  -H "Authorization: Bearer ck_live_…" \
  -H "Content-Type: application/json" \
  -d '{ "source": "https://youtube.com/@canal" }'

{ "item": { "item_id": "itm_…", "type": "youtube_channel", "name": "…" } }
O type é detectado da fonte: URL de canal → youtube_channel, URL de vídeo → youtube_video, feed RSS → rss, etc.

​
2. Sincronize os vídeos de um canal

Um item youtube_channel busca os vídeos uma página por vez. Dispare o sync de uma página (só canais) e passe o cursor retornado em after pra próxima página: 
curl -X POST "https://api.clipping.cc/v1/items/itm_123/sync" \
  -H "Authorization: Bearer ck_live_…"
Sincronizar chama a API do YouTube — o custo real é repassado a você. Normalmente você não precisa sincronizar à mão: um schedule sincroniza os canais das coleções dele antes de cada rodada.

​
3. Liste os vídeos

# todos os vídeos dos seus items
curl "https://api.clipping.cc/v1/videos?limit=50" \
  -H "Authorization: Bearer ck_live_…"

# só os vídeos de um canal
curl "https://api.clipping.cc/v1/videos?item_id=itm_123" \
  -H "Authorization: Bearer ck_live_…"
Cada vídeo traz video_id, título, URL do thumbnail, as coleções a que pertence e viewer_item_id (o item catalogado por você, se houver).

​
4. Inspecione o item

GET /v1/items/{id} devolve o item com suas coleções e (pra vídeos) o canal de origem. Liste tudo que você monitora com GET /v1/items (filtre por ?type=youtube_channel).

​
Próximo

Transcrever

Transforme um vídeo em texto pesquisável.

Montar um reporter

Analise vídeos novos automaticamente.