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).

OperationAufruf
Daten einer Website auflistenGET /sites/{siteId}/dataKostenlos
Dokumente einer Website auflistenGET /sites/{siteId}/documentsKostenlos
Datenblock speichernPOST /sites/{siteId}/dataKostenlos
Datenblock löschenDELETE /sites/{siteId}/data/{blockId}Kostenlos

Daten einer Website auflisten

GET/sites/{siteId}/dataKostenlos

Die auf der Website gespeicherten Datenblöcke: Charts, KPI-Grids und Sitemaps aus Unterhaltungen.

MCP-Tool list_site_data

ArgumentTypBeschreibung
siteIdim PfadstringDie ID.
Anfrage
curl https://app.semchat.io/api/v1/sites/{siteId}/data \
  -H "Authorization: Bearer sk_live_…"
Antwort · 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"
    }
  ]
}

Dokumente einer Website auflisten

GET/sites/{siteId}/documentsKostenlos

Die für die Website geschriebenen Dokumente (Artikel, Briefings…).

MCP-Tool list_site_documents

ArgumentTypBeschreibung
siteIdim PfadstringDie ID.
Anfrage
curl https://app.semchat.io/api/v1/sites/{siteId}/documents \
  -H "Authorization: Bearer sk_live_…"

Antwortet 200 mit { "data": … }.

Datenblock speichern

POST/sites/{siteId}/dataKostenlos

Ein Chart oder ein KPI-Grid auf der Website speichern (wie „Speichern“ bei einem Chart in einer Unterhaltung der App).

MCP-Tool save_data_block

ArgumentTypBeschreibung
siteIdim PfadstringDie ID.
typeerforderlichstringchart oder kpi_grid.chart | kpi_grid
titleerforderlichstring1–500 Zeichen
dataerforderlichobjectDie Props des Charts oder KPI-Grids, so wie ein Block einer Unterhaltung sie enthält.
conversation_idoptionalstringDie Unterhaltung, aus der er stammt.mindestens 1 Zeichen
message_idoptionalstringDie Nachricht, aus der er stammt: Eine Nachricht speichert einen Block pro Titel (409 CONFLICT).mindestens 1 Zeichen
Anfrage
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

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

Einen auf der Website gespeicherten Datenblock löschen.

MCP-Tool delete_data_block

ArgumentTypBeschreibung
siteIdim PfadstringDie ID.
blockIdim PfadstringDie ID.
Anfrage
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.

Bereit, Ihrer Website Aufschwung zu geben?

Stellen Sie Ihre erste Frage - semchat antwortet in Sekunden mit einem klaren Aktionsplan.

Kostenlos · ohne Anmeldung · in 5 Sekunden