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).
| Operazione | Chiamata | |
|---|---|---|
| Elenca i dati del sito | GET /sites/{siteId}/data | Gratis |
| Elenca i documenti del sito | GET /sites/{siteId}/documents | Gratis |
| Salva un blocco di dati | POST /sites/{siteId}/data | Gratis |
| Elimina un blocco di dati | DELETE /sites/{siteId}/data/{blockId} | Gratis |
Elenca i dati del sito
/sites/{siteId}/dataGratisI blocchi di dati salvati sul sito: grafici, griglie KPI e mappe del sito conservati dalle conversazioni.
Strumento MCP list_site_data
| Argomento | Tipo | Descrizione |
|---|---|---|
siteIdnel percorso | string | Il suo 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"
}
]
}Elenca i documenti del sito
/sites/{siteId}/documentsGratisI documenti scritti per il sito (articoli, brief…).
Strumento MCP list_site_documents
| Argomento | Tipo | Descrizione |
|---|---|---|
siteIdnel percorso | string | Il suo id. |
curl https://app.semchat.io/api/v1/sites/{siteId}/documents \
-H "Authorization: Bearer sk_live_…"Risponde 200 con { "data": … }.
Salva un blocco di dati
/sites/{siteId}/dataGratisSalva un grafico o una griglia KPI sul sito (come il pulsante Salva dell'app sul grafico di una conversazione).
Strumento MCP save_data_block
| Argomento | Tipo | Descrizione |
|---|---|---|
siteIdnel percorso | string | Il suo id. |
typeobbligatorio | string | chart o kpi_grid.chart | kpi_grid |
titleobbligatorio | string | 1–500 caratteri |
dataobbligatorio | object | Le props del grafico o della griglia KPI, così come le contiene il blocco di una conversazione. |
conversation_idfacoltativo | string | La conversazione da cui proviene.almeno 1 carattere |
message_idfacoltativo | string | Il messaggio da cui proviene: un messaggio salva un solo blocco per titolo (409 CONFLICT).almeno 1 carattere |
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
/sites/{siteId}/data/{blockId}GratisElimina un blocco di dati salvato sul sito.
Strumento MCP delete_data_block
| Argomento | Tipo | Descrizione |
|---|---|---|
siteIdnel percorso | string | Il suo id. |
blockIdnel percorso | string | Il suo id. |
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.

