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ónLlamada
Listar los datos de un sitioGET /sites/{siteId}/dataGratis
Listar los documentos de un sitioGET /sites/{siteId}/documentsGratis
Guardar un bloque de datosPOST /sites/{siteId}/dataGratis
Eliminar un bloque de datosDELETE /sites/{siteId}/data/{blockId}Gratis

Listar los datos de un sitio

GET/sites/{siteId}/dataGratis

Los 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

ArgumentoTipoDescripción
siteIden la rutastringSu id.
Petición
curl https://app.semchat.io/api/v1/sites/{siteId}/data \
  -H "Authorization: Bearer sk_live_…"
Respuesta · 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 los documentos de un sitio

GET/sites/{siteId}/documentsGratis

Los documentos escritos para el sitio (artículos, briefs…).

Herramienta MCP list_site_documents

ArgumentoTipoDescripción
siteIden la rutastringSu id.
Petición
curl https://app.semchat.io/api/v1/sites/{siteId}/documents \
  -H "Authorization: Bearer sk_live_…"

Responde 200 con { "data": … }.

Guardar un bloque de datos

POST/sites/{siteId}/dataGratis

Guarda 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

ArgumentoTipoDescripción
siteIden la rutastringSu id.
typeobligatoriostringchart o kpi_grid.chart | kpi_grid
titleobligatoriostring1–500 caracteres
dataobligatorioobjectLas props del gráfico o de la cuadrícula de KPI, tal como las lleva el bloque de una conversación.
conversation_idopcionalstringLa conversación de la que viene.al menos 1 carácter
message_idopcionalstringEl mensaje del que viene: un mensaje guarda un bloque por título (409 CONFLICT).al menos 1 carácter
Petición
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

DELETE/sites/{siteId}/data/{blockId}Gratis

Elimina un bloque de datos guardado en el sitio.

Herramienta MCP delete_data_block

ArgumentoTipoDescripción
siteIden la rutastringSu id.
blockIden la rutastringSu id.
Petición
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.

¿Listo para impulsar tu web?

Haz tu primera pregunta - semchat te responde con un plan de acción claro en segundos.

Gratis · sin registro · en 5 segundos