DokumentationAPI-Referenz
Daten und Dokumente
Die gespeicherten Charts, KPI-Grids und Dokumente einer Website.
Jede Operation unten ist auch ein MCP-Tool mit demselben Namen. Operationen mit Kostenlos kosten nichts; Operationen mit Kostenpflichtig verbrauchen die Credits des Workspaces, wie in der App (Was es kostet).
| Operation | Aufruf | |
|---|---|---|
| Daten einer Website auflisten | GET /sites/{siteId}/data | Kostenlos |
| Dokumente einer Website auflisten | GET /sites/{siteId}/documents | Kostenlos |
| Datenblock speichern | POST /sites/{siteId}/data | Kostenlos |
| Datenblock löschen | DELETE /sites/{siteId}/data/{blockId} | Kostenlos |
Daten einer Website auflisten
/sites/{siteId}/dataKostenlosDie auf der Website gespeicherten Datenblöcke: Charts, KPI-Grids und Sitemaps aus Unterhaltungen.
MCP-Tool list_site_data
| Argument | Typ | Beschreibung |
|---|---|---|
siteIdim Pfad | string | Die 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"
}
]
}Dokumente einer Website auflisten
/sites/{siteId}/documentsKostenlosDie für die Website geschriebenen Dokumente (Artikel, Briefings…).
MCP-Tool list_site_documents
| Argument | Typ | Beschreibung |
|---|---|---|
siteIdim Pfad | string | Die ID. |
curl https://app.semchat.io/api/v1/sites/{siteId}/documents \
-H "Authorization: Bearer sk_live_…"Antwortet 200 mit { "data": … }.
Datenblock speichern
/sites/{siteId}/dataKostenlosEin Chart oder ein KPI-Grid auf der Website speichern (wie „Speichern“ bei einem Chart in einer Unterhaltung der App).
MCP-Tool save_data_block
| Argument | Typ | Beschreibung |
|---|---|---|
siteIdim Pfad | string | Die ID. |
typeerforderlich | string | chart oder kpi_grid.chart | kpi_grid |
titleerforderlich | string | 1–500 Zeichen |
dataerforderlich | object | Die Props des Charts oder KPI-Grids, so wie ein Block einer Unterhaltung sie enthält. |
conversation_idoptional | string | Die Unterhaltung, aus der er stammt.mindestens 1 Zeichen |
message_idoptional | string | Die Nachricht, aus der er stammt: Eine Nachricht speichert einen Block pro Titel (409 CONFLICT).mindestens 1 Zeichen |
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": {}}'Antwortet 201 mit { "data": … }.
Datenblock löschen
/sites/{siteId}/data/{blockId}KostenlosEinen auf der Website gespeicherten Datenblock löschen.
MCP-Tool delete_data_block
| Argument | Typ | Beschreibung |
|---|---|---|
siteIdim Pfad | string | Die ID. |
blockIdim Pfad | string | Die ID. |
curl -X DELETE https://app.semchat.io/api/v1/sites/{siteId}/data/{blockId} \
-H "Authorization: Bearer sk_live_…"Antwortet 204 mit { "data": … }.
Keine Antwort auf Ihre Frage gefunden? Schreiben Sie uns.

