DocumentazioneRiferimento API

Dati e documenti

I grafici, le griglie KPI e i documenti salvati di un sito.

Ogni operazione qui sotto è anche uno strumento MCP, con lo stesso nome. Le operazioni Gratis non costano nulla; quelle A pagamento usano i crediti dello spazio di lavoro, come nell'app (Quanto costa).

OperazioneChiamata
Elenca i dati del sitoGET /sites/{siteId}/dataGratis
Elenca i documenti del sitoGET /sites/{siteId}/documentsGratis
Salva un blocco di datiPOST /sites/{siteId}/dataGratis
Elimina un blocco di datiDELETE /sites/{siteId}/data/{blockId}Gratis

Elenca i dati del sito

GET/sites/{siteId}/dataGratis

I blocchi di dati salvati sul sito: grafici, griglie KPI e mappe del sito conservati dalle conversazioni.

Strumento MCP list_site_data

ArgomentoTipoDescrizione
siteIdnel percorsostringIl suo id.
Richiesta
curl https://app.semchat.io/api/v1/sites/{siteId}/data \
  -H "Authorization: Bearer sk_live_…"
Risposta · 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"
    }
  ]
}

Elenca i documenti del sito

GET/sites/{siteId}/documentsGratis

I documenti scritti per il sito (articoli, brief…).

Strumento MCP list_site_documents

ArgomentoTipoDescrizione
siteIdnel percorsostringIl suo id.
Richiesta
curl https://app.semchat.io/api/v1/sites/{siteId}/documents \
  -H "Authorization: Bearer sk_live_…"

Risponde 200 con { "data": … }.

Salva un blocco di dati

POST/sites/{siteId}/dataGratis

Salva un grafico o una griglia KPI sul sito (come il pulsante Salva dell'app sul grafico di una conversazione).

Strumento MCP save_data_block

ArgomentoTipoDescrizione
siteIdnel percorsostringIl suo id.
typeobbligatoriostringchart o kpi_grid.chart | kpi_grid
titleobbligatoriostring1–500 caratteri
dataobbligatorioobjectLe props del grafico o della griglia KPI, così come le contiene il blocco di una conversazione.
conversation_idfacoltativostringLa conversazione da cui proviene.almeno 1 carattere
message_idfacoltativostringIl messaggio da cui proviene: un messaggio salva un solo blocco per titolo (409 CONFLICT).almeno 1 carattere
Richiesta
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": {}}'

Risponde 201 con { "data": … }.

Elimina un blocco di dati

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

Elimina un blocco di dati salvato sul sito.

Strumento MCP delete_data_block

ArgomentoTipoDescrizione
siteIdnel percorsostringIl suo id.
blockIdnel percorsostringIl suo id.
Richiesta
curl -X DELETE https://app.semchat.io/api/v1/sites/{siteId}/data/{blockId} \
  -H "Authorization: Bearer sk_live_…"

Risponde 204 con { "data": … }.

Hai una domanda a cui qui non trovi risposta? Scrivici.

Pronto a far decollare il tuo sito?

Fai la tua prima domanda - semchat ti risponde con un piano d'azione chiaro in pochi secondi.

Gratis · senza registrazione · in 5 secondi