DokumentationAPI & MCP

Schnellstart

Einen Schlüssel erstellen, den ersten Aufruf machen und die Antworten lesen.

Alles, was Sie in semchat tun, aus Ihrem eigenen Code (die API) oder aus Ihrem KI-Assistenten (MCP): Ihre Websites, ihre Analyse, Aktionspläne, Keywords, Wettbewerber, Backlinks, Dokumente, geplante Aufgaben und der Chat von semchat. Dieselben Aktionen wie in der App, zu denselben Preisen.

Einen Schlüssel erhalten

  1. 1Einstellungen → API & MCP öffnenIn Ihrem Workspace, in semchat. Nur der Inhaber und die Administratoren erstellen und widerrufen Schlüssel.
  2. 2Einen Schlüssel erstellenGeben Sie ihm einen Namen und kopieren Sie ihn dann: Er wird nur einmal angezeigt.
  3. 3Widerrufen, wenn er in falsche Hände gerätWiderrufen im selben Tab: Der Schlüssel funktioniert sofort nicht mehr.
Ein Schlüssel wirkt auf den ganzen Workspace. Bewahren Sie ihn auf einem Server auf, nie in einer öffentlichen Website oder App.
Einstellungen › API & MCP: die Schlüssel, der MCP-Server und die Einrichtung für jeden Assistenten

Authentifizierung

Jede Anfrage enthält den Schlüssel im Header Authorization: Bearer (oder X-API-Key). Die Basis-URL ist https://app.semchat.io/api/v1. Anfragen und Antworten sind JSON.

curl https://app.semchat.io/api/v1/sites \
  -H "Authorization: Bearer sk_live_…"

Ohne gültigen Schlüssel lautet die Antwort 401: siehe Fehler und Limits.

Eine erste Website

Erstellen Sie eine Website und starten Sie ihre Analyse im selben Aufruf. Die Analyse ist kostenpflichtig; needs_credits zeigt an, wenn die Credits nicht dafür gereicht haben.

curl -X POST https://app.semchat.io/api/v1/sites \
  -H "Authorization: Bearer sk_live_…" \
  -H "Content-Type: application/json" \
  -d '{"name": "My shop", "site_url": "https://myshop.com", "auto_analyze": true}'

Lesen Sie dann ihren Aktionsplan mit Aufgaben auflisten oder fragen Sie den Chat dazu mit Nachricht in einer Website senden.

Antworten

  • Eine Antwort ist { "data": … }: ein Objekt oder eine Liste mit allen Einträgen.
  • Datumsangaben sind ISO 8601 in UTC, IDs sind UUIDs.
  • Credits erscheinen nie als Rohzahlen, nur als Anteil des Zeitraums: Workspace abrufen, Nutzung abrufen.

Was ein Schlüssel sieht

Ein Schlüssel gehört zu einem Workspace: Er sieht die Websites und Unterhaltungen dieses Workspaces und sonst nichts, und er handelt mit den Rechten des Mitglieds, das ihn erstellt hat.

Das OpenAPI-Dokument

Die ganze Referenz als OpenAPI 3.1, zum Importieren in Postman, Insomnia oder einen Client-Generator: openapi.json.

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