DocumentaçãoAPI e MCP
Primeiros passos
Crie uma chave, faça a sua primeira chamada e leia as respostas.
Tudo o que você faz no semchat, a partir do seu próprio código (a API) ou do seu assistente de IA (MCP): os seus sites, a análise deles, planos de ação, palavras-chave, concorrentes, backlinks, documentos, tarefas agendadas e o chat do semchat. As mesmas ações do aplicativo, pelos mesmos preços.
Obter uma chave
- 1Abra Definições → API e MCPNo seu espaço de trabalho, no semchat. Só o proprietário e os administradores criam e revogam chaves.
- 2Crie uma chaveDê um nome a ela e depois copie: ela só aparece uma vez.
- 3Revogue a chave se ela vazarRevogar, na mesma aba: a chave para de funcionar na hora.
Autenticação
Toda requisição leva a chave no cabeçalho Authorization: Bearer (ou X-API-Key). A URL base é https://app.semchat.io/api/v1. Os corpos e as respostas são em JSON.
curl https://app.semchat.io/api/v1/sites \
-H "Authorization: Bearer sk_live_…"Sem uma chave válida, a resposta é um 401: veja Erros e limites.
Um primeiro site
Crie um site e inicie a análise dele na mesma chamada. A análise é cobrada; needs_credits indica quando os créditos não foram suficientes para pagá-la.
curl -X POST https://app.semchat.io/api/v1/sites \
-H "Authorization: Bearer sk_live_…" \
-H "Content-Type: application/json" \
-d '{"name": "My shop", "site_url": "https://myshop.com", "auto_analyze": true}'Depois, leia o plano de ação dele com Listar as tarefas, ou pergunte ao chat sobre ele com Enviar uma mensagem em um site.
Respostas
- Uma resposta é
{ "data": … }: um objeto, ou uma lista com todos os itens. - As datas estão em ISO 8601, em UTC, e os ids são UUIDs.
- Os créditos nunca aparecem como números brutos, só como porcentagem do período: Obter o espaço de trabalho, Obter o uso.
O que uma chave pode ver
Uma chave pertence a um espaço de trabalho: ela vê os sites e as conversas desse espaço e mais nada, e age com as permissões do membro que a criou.
O documento OpenAPI
A referência completa em OpenAPI 3.1, para importar no Postman, no Insomnia ou em um gerador de clientes: openapi.json.
Não encontrou a resposta? Fale com a gente.

