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
- 1Einstellungen → API & MCP öffnenIn Ihrem Workspace, in semchat. Nur der Inhaber und die Administratoren erstellen und widerrufen Schlüssel.
- 2Einen Schlüssel erstellenGeben Sie ihm einen Namen und kopieren Sie ihn dann: Er wird nur einmal angezeigt.
- 3Widerrufen, wenn er in falsche Hände gerätWiderrufen im selben Tab: Der Schlüssel funktioniert sofort nicht mehr.
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.

