DocumentaçãoReferência da API

Dados e documentos

Os gráficos, as grades de KPI e os documentos salvos de um site.

Cada operação abaixo também é uma ferramenta MCP, com o mesmo nome. As operações marcadas Grátis não custam nada; as marcadas Cobrado usam os créditos do espaço de trabalho, como no aplicativo (Quanto custa).

OperaçãoChamada
Listar os dados de um siteGET /sites/{siteId}/dataGrátis
Listar os documentos de um siteGET /sites/{siteId}/documentsGrátis
Salvar um bloco de dadosPOST /sites/{siteId}/dataGrátis
Excluir um bloco de dadosDELETE /sites/{siteId}/data/{blockId}Grátis

Listar os dados de um site

GET/sites/{siteId}/dataGrátis

Os blocos de dados salvos no site: gráficos, grades de KPI e mapas do site guardados das conversas.

Ferramenta MCP list_site_data

ArgumentoTipoDescrição
siteIdno caminhostringO id dele.
Requisição
curl https://app.semchat.io/api/v1/sites/{siteId}/data \
  -H "Authorization: Bearer sk_live_…"
Resposta · 200
{
  "data": [
    {
      "id": "01a15ea4-c1e0-7157-becb-0b33c960722e",
      "type": "kpi_grid",
      "title": "Vue d'ensemble - alpha",
      "data": {
        "title": "Vue d'ensemble - alpha",
        "cards": [
          "…",
          "…"
        ]
      },
      "conversation_id": "01a1597c-9120-70b0-87de-f58bf6fe953e",
      "created_at": "2026-10-18T13:26:58.000Z"
    },
    {
      "id": "01a15ea4-c1e0-730a-a3c7-1cf43b1cd203",
      "type": "chart",
      "title": "Trafic organique - alpha vs concurrents",
      "data": {
        "title": "Trafic organique - alpha vs concurrents",
        "type": "bar",
        "x_key": "domain",
        "y_keys": [
          "trafic"
        ],
        "data": [
          "…",
          "…"
        ],
        "format": "number",
        "unit": "visites/mois"
      },
      "conversation_id": "01a15456-3520-7443-9b04-564ff63c5448",
      "created_at": "2026-10-17T13:26:58.000Z"
    }
  ]
}

Listar os documentos de um site

GET/sites/{siteId}/documentsGrátis

Os documentos escritos para o site (artigos, briefings…).

Ferramenta MCP list_site_documents

ArgumentoTipoDescrição
siteIdno caminhostringO id dele.
Requisição
curl https://app.semchat.io/api/v1/sites/{siteId}/documents \
  -H "Authorization: Bearer sk_live_…"

Responde 200 com { "data": … }.

Salvar um bloco de dados

POST/sites/{siteId}/dataGrátis

Salva um gráfico ou uma grade de KPI no site (como o “Guardar” do aplicativo no gráfico de uma conversa).

Ferramenta MCP save_data_block

ArgumentoTipoDescrição
siteIdno caminhostringO id dele.
typeobrigatóriostringchart ou kpi_grid.chart | kpi_grid
titleobrigatóriostring1–500 caracteres
dataobrigatórioobjectAs props do gráfico ou da grade de KPI, como o bloco de uma conversa as traz.
conversation_idopcionalstringA conversa de onde ele vem.pelo menos 1 caractere
message_idopcionalstringA mensagem de onde ele vem: uma mensagem salva um bloco por título (409 CONFLICT).pelo menos 1 caractere
Requisição
curl -X POST https://app.semchat.io/api/v1/sites/{siteId}/data \
  -H "Authorization: Bearer sk_live_…" \
  -H "Content-Type: application/json" \
  -d '{"type": "chart", "title": "…", "data": {}}'

Responde 201 com { "data": … }.

Excluir um bloco de dados

DELETE/sites/{siteId}/data/{blockId}Grátis

Exclui um bloco de dados salvo no site.

Ferramenta MCP delete_data_block

ArgumentoTipoDescrição
siteIdno caminhostringO id dele.
blockIdno caminhostringO id dele.
Requisição
curl -X DELETE https://app.semchat.io/api/v1/sites/{siteId}/data/{blockId} \
  -H "Authorization: Bearer sk_live_…"

Responde 204 com { "data": … }.

Não encontrou a resposta? Fale com a gente.

Pronto para fazer seu site decolar?

Faça sua primeira pergunta - o semchat responde com um plano de ação claro em segundos.

Grátis · sem cadastro · em 5 segundos