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

# Quickstart

> Sua primeira chamada à API em menos de 5 minutos.

## 1. Crie uma API key

Acesse [clipping.cc/account](https://clipping.cc/account), vá em **API keys** e
clique em **criar key**. O segredo (`ck_live_…`) é mostrado **uma única vez** —
copie e guarde num lugar seguro. Se perder, revogue e crie outra.

<Warning>
  A key carrega acesso à sua conta e consome do seu saldo. Trate como senha:
  nunca exponha em código de frontend ou repositórios públicos.
</Warning>

## 2. Garanta saldo na conta

Cada chamada consome do saldo da conta dona da key. Sem saldo, a API responde
`402 Payment Required`. Adicione coins em [clipping.cc/balance](https://clipping.cc/balance).
Veja [cobrança](/billing) pra entender os preços.

## 3. Faça a primeira chamada

Confirme a key chamando `/v1/accounts/me`:

<CodeGroup>
  ```bash cURL theme={null}
  curl https://api.clipping.cc/v1/accounts/me \
    -H "Authorization: Bearer ck_live_SEU_SEGREDO"
  ```

  ```javascript JavaScript theme={null}
  const res = await fetch("https://api.clipping.cc/v1/accounts/me", {
    headers: { Authorization: "Bearer ck_live_SEU_SEGREDO" },
  });
  const me = await res.json();
  console.log(me);
  ```

  ```python Python theme={null}
  import requests

  res = requests.get(
      "https://api.clipping.cc/v1/accounts/me",
      headers={"Authorization": "Bearer ck_live_SEU_SEGREDO"},
  )
  print(res.json())
  ```
</CodeGroup>

Resposta:

```json theme={null}
{
  "account": {
    "user_id": "…",
    "balance_microcoins": 1000000,
    "balance_coins": 1.0,
    "withdrawable_coins": 1.0
  }
}
```

## 4. Explore

```bash theme={null}
# seus items
curl https://api.clipping.cc/v1/items \
  -H "Authorization: Bearer ck_live_SEU_SEGREDO"

# busca semântica no seu acervo
curl "https://api.clipping.cc/v1/search?q=inteligencia%20artificial" \
  -H "Authorization: Bearer ck_live_SEU_SEGREDO"
```

Veja todos os endpoints na aba **Referência da API** (menu superior).

## Próximos passos

<CardGroup cols={2}>
  <Card title="Conceitos" icon="diagram-project" href="/pt/concepts">
    O modelo de dados — items, coleções, reporters, workflows, executions.
  </Card>

  <Card title="Operações assíncronas" icon="hourglass-half" href="/pt/async-operations">
    Como escritas retornam `202` + uma execution, e como acompanhar.
  </Card>

  <Card title="Monitorar uma fonte" icon="rss" href="/pt/guides/monitor-a-source">
    Adicione um canal, sincronize, liste os vídeos.
  </Card>

  <Card title="Montar um reporter" icon="robot" href="/pt/guides/build-a-reporter">
    Um workflow que analisa fontes automaticamente.
  </Card>
</CardGroup>