> ## 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.

# Monitorar uma fonte

> Adicione uma fonte, sincronize o conteúdo e liste os vídeos.

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):

```bash theme={null}
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" }'
```

```json theme={null}
{ "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:

```bash theme={null}
curl -X POST "https://api.clipping.cc/v1/items/itm_123/sync" \
  -H "Authorization: Bearer ck_live_…"
```

<Note>
  Sincronizar chama a API do YouTube — o custo real é repassado a você.
  Normalmente você não precisa sincronizar à mão: um
  [schedule](/pt/guides/schedule-runs) sincroniza os canais das coleções dele
  antes de cada rodada.
</Note>

## 3. Liste os vídeos

```bash theme={null}
# 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

<CardGroup cols={2}>
  <Card title="Transcrever" icon="closed-captioning" href="/pt/guides/transcribe">
    Transforme um vídeo em texto pesquisável.
  </Card>

  <Card title="Montar um reporter" icon="robot" href="/pt/guides/build-a-reporter">
    Analise vídeos novos automaticamente.
  </Card>
</CardGroup>