DokumentationAPI-Referenz

Content-Ideen

Die Content-Ideen einer Website: auflisten, hinzufügen 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
Content-Ideen auflistenGET /sites/{siteId}/content-ideasKostenlos
Content-Idee hinzufügenPOST /sites/{siteId}/content-ideasKostenlos
Content-Idee löschenDELETE /sites/{siteId}/content-ideas/{ideaId}Kostenlos

Content-Ideen auflisten

GET/sites/{siteId}/content-ideasKostenlos

Die Content-Ideen der Website: zu schreibende Artikel, jeweils mit Keyword, Schwerpunkt und Begründung.

  • 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_content_ideas

ArgumentTypBeschreibung
siteIdim PfadstringDie ID.
Anfrage
curl https://app.semchat.io/api/v1/sites/{siteId}/content-ideas \
  -H "Authorization: Bearer sk_live_…"
Antwort · 200
{
  "data": [
    {
      "id": "01a15ea4-c1e0-7736-9a1d-b79cfd3e485e",
      "title": "Combien coûte un audit SEO ?",
      "content_type": "faq",
      "primary_keyword": "référencement naturel pme",
      "volume": 880,
      "difficulty": 35,
      "intent": "informational",
      "angle": "Angle : combien coûte un audit seo ?",
      "rationale": "Fort intérêt, peu de concurrence.",
      "source": "auto",
      "source_lang": "fr",
      "created_at": "2026-10-21T13:26:58.000Z"
    },
    {
      "id": "01a15ea4-c1e0-7aec-b48b-474893e6ef98",
      "title": "Les 7 erreurs SEO des PME",
      "content_type": "listicle",
      "primary_keyword": "stratégie de contenu seo",
      "volume": 590,
      "difficulty": 40,
      "intent": "informational",
      "angle": "Angle : les 7 erreurs seo des pme",
      "rationale": "Fort intérêt, peu de concurrence.",
      "source": "auto",
      "source_lang": "fr",
      "created_at": "2026-10-21T13:26:58.000Z"
    }
  ]
}

Content-Idee hinzufügen

POST/sites/{siteId}/content-ideasKostenlos

Eine Content-Idee zur Website hinzufügen.

  • Als manuelle Idee angelegt. Antwortet mit der Idee.

MCP-Tool add_content_idea

ArgumentTypBeschreibung
siteIdim PfadstringDie ID.
titleerforderlichstringDer Titel des Artikels.1–300 Zeichen
content_typeoptionalstring | nullblog_post, guide, comparison, faq, how_to, listicle oder landing.
primary_keywordoptionalstring | nullDas Keyword, auf das er zielt.
intentoptionalstring | nullinformational, commercial, transactional oder navigational.
angleoptionalstring | nullWas der Artikel abdecken soll.
rationaleoptionalstring | nullWarum er geschrieben werden sollte.
volumeoptionalstring | null
difficultyoptionalstring | null
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}/content-ideas \
  -H "Authorization: Bearer sk_live_…" \
  -H "Content-Type: application/json" \
  -d '{"title": "…"}'

Antwortet 201 mit { "data": … }.

Content-Idee löschen

DELETE/sites/{siteId}/content-ideas/{ideaId}Kostenlos

Eine Content-Idee von der Website entfernen.

MCP-Tool delete_content_idea

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