Quickstart

1. Crie uma API key

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

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.

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. Veja cobrança pra entender os preços.

3. Faça a primeira chamada

Confirme a key chamando /v1/accounts/me:

curl https://api.clipping.cc/v1/accounts/me \
  -H "Authorization: Bearer ck_live_SEU_SEGREDO"

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

import requests

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

Resposta:

{
  "account": {
    "user_id": "…",
    "balance_microcoins": 1000000,
    "balance_coins": 1.0,
    "withdrawable_coins": 1.0
  }
}

4. Explore

# 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

Conceitos

O modelo de dados — items, coleções, reporters, workflows, executions.

Operações assíncronas

Como escritas retornam 202 + uma execution, e como acompanhar.

Monitorar uma fonte

Adicione um canal, sincronize, liste os vídeos.

Montar um reporter

Um workflow que analisa fontes automaticamente.

Começando

Conceitos

Guias

1. Crie uma API key

2. Garanta saldo na conta

3. Faça a primeira chamada

4. Explore

Próximos passos

Conceitos

Operações assíncronas

Monitorar uma fonte

Montar um reporter

​1. Crie uma API key

​2. Garanta saldo na conta

​3. Faça a primeira chamada

​4. Explore

​Próximos passos

Conceitos

Operações assíncronas

Monitorar uma fonte

Montar um reporter

1. Crie uma API key

2. Garanta saldo na conta

3. Faça a primeira chamada

4. Explore

Próximos passos