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

# Introdução

> Uma API para monitorar fontes, rodar agentes e analisar sua biblioteca.

A **API do clipping** é uma API HTTP única, sob `/v1`, pra tudo que a plataforma
faz: monitorar fontes (canais e vídeos do YouTube, RSS, X), transcrever e
analisar com agentes, organizar em coleções e buscar na biblioteca inteira.

## O modelo

<CardGroup cols={2}>
  <Card title="Items" icon="rss">
    Uma fonte monitorada — canal do YouTube, um vídeo, um feed RSS. A unidade
    atômica; todo o resto aponta de volta pros items.
  </Card>

  <Card title="Coleções" icon="folder">
    Agrupam items. Privadas ou públicas; podem ser **pagas** (fãs assinam).
  </Card>

  <Card title="Reporters" icon="robot">
    Agentes que processam fontes. Um reporter roda **workflows** (sequência de
    **steps**, cada um uma tool + prompt) e pode rodar em **schedule**.
  </Card>

  <Card title="Executions" icon="diagram-project">
    Toda execução (transcript, workflow, schedule) cria uma execution que você
    acompanha até concluir.
  </Card>

  <Card title="Transcripts & documents" icon="file-lines">
    Artefatos produzidos a partir dos items: transcripts (um por idioma) e
    documents (resumos e outras saídas de workflow).
  </Card>

  <Card title="Search & discover" icon="magnifying-glass">
    Busca semântica na sua biblioteca, e um catálogo público (`discover`) de
    coleções, reporters e usuários.
  </Card>
</CardGroup>

Como se relacionam:

```
item ──(agrupado em)───▶ coleção
item ──(produz)────────▶ videos · transcripts · documents
reporter ──(tem)───────▶ workflow ──(tem)──▶ steps (tool + prompt)
reporter ──(roda em)───▶ schedule ──(mira)──▶ coleções
execução (transcript / workflow / schedule) ──▶ execution
```

## Base URL

A API inteira vive sob `/v1`:

```
https://api.clipping.cc/v1
```

## Dois crachás, uma API

Os mesmos endpoints aceitam **qualquer** um dos crachás — só muda a cobrança:

* **API key** (`ck_live_…`) — pra integradores. Cobrada por chamada do saldo da
  key (taxa flat de plataforma + pass-through). É o que estes guias usam.
* **JWT de sessão** — o que o app web usa (de `POST /v1/auth/login`). Sem taxa de
  plataforma, só pass-through.

Veja [Autenticação](/pt/authentication) e [Cobrança](/pt/billing).

<Card title="Próximo" icon="arrow-right" href="/pt/quickstart">
  Faça a primeira chamada no [quickstart](/pt/quickstart), depois leia
  [Conceitos](/pt/concepts) — em especial [operações assíncronas](/pt/async-operations),
  de que a maioria das escritas depende.
</Card>