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ção | Chamada | |
|---|---|---|
| Listar os dados de um site | GET /sites/{siteId}/data | Grátis |
| Listar os documentos de um site | GET /sites/{siteId}/documents | Grátis |
| Salvar um bloco de dados | POST /sites/{siteId}/data | Grátis |
| Excluir um bloco de dados | DELETE /sites/{siteId}/data/{blockId} | Grátis |
Listar os dados de um site
/sites/{siteId}/dataGrátisOs blocos de dados salvos no site: gráficos, grades de KPI e mapas do site guardados das conversas.
Ferramenta MCP list_site_data
| Argumento | Tipo | Descrição |
|---|---|---|
siteIdno caminho | string | O id dele. |
curl https://app.semchat.io/api/v1/sites/{siteId}/data \
-H "Authorization: Bearer sk_live_…"{
"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
/sites/{siteId}/documentsGrátisOs documentos escritos para o site (artigos, briefings…).
Ferramenta MCP list_site_documents
| Argumento | Tipo | Descrição |
|---|---|---|
siteIdno caminho | string | O id dele. |
curl https://app.semchat.io/api/v1/sites/{siteId}/documents \
-H "Authorization: Bearer sk_live_…"Responde 200 com { "data": … }.
Salvar um bloco de dados
/sites/{siteId}/dataGrátisSalva 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
| Argumento | Tipo | Descrição |
|---|---|---|
siteIdno caminho | string | O id dele. |
typeobrigatório | string | chart ou kpi_grid.chart | kpi_grid |
titleobrigatório | string | 1–500 caracteres |
dataobrigatório | object | As props do gráfico ou da grade de KPI, como o bloco de uma conversa as traz. |
conversation_idopcional | string | A conversa de onde ele vem.pelo menos 1 caractere |
message_idopcional | string | A mensagem de onde ele vem: uma mensagem salva um bloco por título (409 CONFLICT).pelo menos 1 caractere |
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
/sites/{siteId}/data/{blockId}GrátisExclui um bloco de dados salvo no site.
Ferramenta MCP delete_data_block
| Argumento | Tipo | Descrição |
|---|---|---|
siteIdno caminho | string | O id dele. |
blockIdno caminho | string | O id dele. |
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.

