DocumentaciónReferencia de la API
Datos y documentos
Los gráficos, las cuadrículas de KPI y los documentos guardados de un sitio.
Cada operación de esta página es también una herramienta MCP, con el mismo nombre. Las marcadas Gratis no cuestan nada; las marcadas De pago usan los créditos del espacio, como en la aplicación (Cuánto cuesta).
| Operación | Llamada | |
|---|---|---|
| Listar los datos de un sitio | GET /sites/{siteId}/data | Gratis |
| Listar los documentos de un sitio | GET /sites/{siteId}/documents | Gratis |
| Guardar un bloque de datos | POST /sites/{siteId}/data | Gratis |
| Eliminar un bloque de datos | DELETE /sites/{siteId}/data/{blockId} | Gratis |
Listar los datos de un sitio
/sites/{siteId}/dataGratisLos bloques de datos guardados en el sitio: gráficos, cuadrículas de KPI y mapas del sitio conservados desde las conversaciones.
Herramienta MCP list_site_data
| Argumento | Tipo | Descripción |
|---|---|---|
siteIden la ruta | string | Su id. |
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 los documentos de un sitio
/sites/{siteId}/documentsGratisLos documentos escritos para el sitio (artículos, briefs…).
Herramienta MCP list_site_documents
| Argumento | Tipo | Descripción |
|---|---|---|
siteIden la ruta | string | Su id. |
curl https://app.semchat.io/api/v1/sites/{siteId}/documents \
-H "Authorization: Bearer sk_live_…"Responde 200 con { "data": … }.
Guardar un bloque de datos
/sites/{siteId}/dataGratisGuarda un gráfico o una cuadrícula de KPI en el sitio (como «Guardar» en el gráfico de una conversación, en la aplicación).
Herramienta MCP save_data_block
| Argumento | Tipo | Descripción |
|---|---|---|
siteIden la ruta | string | Su id. |
typeobligatorio | string | chart o kpi_grid.chart | kpi_grid |
titleobligatorio | string | 1–500 caracteres |
dataobligatorio | object | Las props del gráfico o de la cuadrícula de KPI, tal como las lleva el bloque de una conversación. |
conversation_idopcional | string | La conversación de la que viene.al menos 1 carácter |
message_idopcional | string | El mensaje del que viene: un mensaje guarda un bloque por título (409 CONFLICT).al menos 1 carácter |
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 con { "data": … }.
Eliminar un bloque de datos
/sites/{siteId}/data/{blockId}GratisElimina un bloque de datos guardado en el sitio.
Herramienta MCP delete_data_block
| Argumento | Tipo | Descripción |
|---|---|---|
siteIden la ruta | string | Su id. |
blockIden la ruta | string | Su id. |
curl -X DELETE https://app.semchat.io/api/v1/sites/{siteId}/data/{blockId} \
-H "Authorization: Bearer sk_live_…"Responde 204 con { "data": … }.
¿No encuentras la respuesta? Escríbenos.

