DokumentationAPI-Referenz

Keywords

Die Keywords einer Website: auflisten, hinzufügen, ändern und löschen.

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
Keywords auflistenGET /sites/{siteId}/keywordsKostenlos
Keyword hinzufügenPOST /sites/{siteId}/keywordsKostenlos
Keyword ändernPATCH /sites/{siteId}/keywords/{keywordId}Kostenlos
Keyword löschenDELETE /sites/{siteId}/keywords/{keywordId}Kostenlos

Keywords auflisten

GET/sites/{siteId}/keywordsKostenlos

Die Ziel-Keywords der Website, aus ihrer Analyse oder von Hand hinzugefügt, mit Suchvolumen, Schwierigkeit und aktueller Position.

  • Text wird so zurückgegeben, wie er gespeichert ist, in der Sprache, in der er geschrieben wurde (source_lang; null = die Inhaltssprache der Website). Die App übersetzt ihn bei der Anzeige, die API nicht.

MCP-Tool list_keywords

ArgumentTypBeschreibung
siteIdim PfadstringDie ID.
Anfrage
curl https://app.semchat.io/api/v1/sites/{siteId}/keywords \
  -H "Authorization: Bearer sk_live_…"
Antwort · 200
{
  "data": [
    {
      "id": "01a15ea4-c1e0-7957-b667-9b025ed3641e",
      "keyword": "agence seo lyon",
      "volume": 1900,
      "difficulty": 45,
      "cpc": 1.8,
      "competition": 40,
      "current_position": 4,
      "traffic": 475,
      "url": "https://alpha.example.com/services",
      "intent": "commercial",
      "priority": "high",
      "rationale": "Opportunité sur « agence seo lyon ».",
      "source": "auto",
      "source_lang": "fr",
      "created_at": "2026-10-21T13:26:58.000Z"
    },
    {
      "id": "01a15ea4-c1e0-7e93-9a50-38742b693311",
      "keyword": "audit seo",
      "volume": 2400,
      "difficulty": 60,
      "cpc": 1.8,
      "competition": 40,
      "current_position": 12,
      "traffic": 200,
      "url": "https://alpha.example.com/services",
      "intent": "commercial",
      "priority": "high",
      "rationale": "Opportunité sur « audit seo ».",
      "source": "auto",
      "source_lang": "fr",
      "created_at": "2026-10-21T13:26:58.000Z"
    }
  ]
}

Keyword hinzufügen

POST/sites/{siteId}/keywordsKostenlos

Ein Ziel-Keyword zur Website hinzufügen.

  • So gespeichert, wie angegeben, als manuelles Keyword: Es werden keine Keyword-Daten abgerufen (nichts wird abgerechnet). Antwortet mit dem Keyword.

MCP-Tool add_keyword

ArgumentTypBeschreibung
siteIdim PfadstringDie ID.
keyworderforderlichstringDas Keyword.1–255 Zeichen
volumeoptionalstring | nullSein monatliches Suchvolumen, falls bekannt.
difficultyoptionalstring | nullSeine Schwierigkeit, 0–100, falls bekannt.
intentoptionalstring | nullinformational, commercial, transactional oder navigational.
priorityoptionalstringhigh, medium (Standard) oder low.high | medium | low
rationaleoptionalstring | nullWarum es sich lohnt.
source_langoptionalstringDie Sprache, in der der Text geschrieben ist (z. B. "fr", "en"). Ohne Angabe: die Inhaltssprache der Website.2–5 Zeichen
Anfrage
curl -X POST https://app.semchat.io/api/v1/sites/{siteId}/keywords \
  -H "Authorization: Bearer sk_live_…" \
  -H "Content-Type: application/json" \
  -d '{"keyword": "…"}'

Antwortet 201 mit { "data": … }.

Keyword ändern

PATCH/sites/{siteId}/keywords/{keywordId}Kostenlos

Ein Ziel-Keyword ändern: das Keyword, seine Kennzahlen, Suchintention, Priorität oder Begründung.

  • Antwortet mit dem Keyword in seinem neuen Stand.

MCP-Tool update_keyword

ArgumentTypBeschreibung
siteIdim PfadstringDie ID.
keywordIdim PfadstringDie ID.
keywordoptionalstring1–255 Zeichen
volumeoptionalstring | null
difficultyoptionalstring | null
intentoptionalstring | null
priorityoptionalstringhigh | medium | low
rationaleoptionalstring | null
source_langoptionalstringDie Sprache des neuen Keywords bzw. der neuen Begründung. Wird ignoriert, wenn sich keins von beiden ändert.2–5 Zeichen
Anfrage
curl -X PATCH https://app.semchat.io/api/v1/sites/{siteId}/keywords/{keywordId} \
  -H "Authorization: Bearer sk_live_…" \
  -H "Content-Type: application/json" \
  -d '{"keyword": "…"}'

Antwortet 200 mit { "data": … }.

Keyword löschen

DELETE/sites/{siteId}/keywords/{keywordId}Kostenlos

Ein Ziel-Keyword von der Website entfernen.

MCP-Tool delete_keyword

ArgumentTypBeschreibung
siteIdim PfadstringDie ID.
keywordIdim PfadstringDie ID.
Anfrage
curl -X DELETE https://app.semchat.io/api/v1/sites/{siteId}/keywords/{keywordId} \
  -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