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).
| Operation | Aufruf | |
|---|---|---|
| Content-Ideen auflisten | GET /sites/{siteId}/content-ideas | Kostenlos |
| Content-Idee hinzufügen | POST /sites/{siteId}/content-ideas | Kostenlos |
| Content-Idee löschen | DELETE /sites/{siteId}/content-ideas/{ideaId} | Kostenlos |
Content-Ideen auflisten
/sites/{siteId}/content-ideasKostenlosDie 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
| Argument | Typ | Beschreibung |
|---|---|---|
siteIdim Pfad | string | Die ID. |
curl https://app.semchat.io/api/v1/sites/{siteId}/content-ideas \
-H "Authorization: Bearer sk_live_…"{
"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
/sites/{siteId}/content-ideasKostenlosEine Content-Idee zur Website hinzufügen.
- Als manuelle Idee angelegt. Antwortet mit der Idee.
MCP-Tool add_content_idea
| Argument | Typ | Beschreibung |
|---|---|---|
siteIdim Pfad | string | Die ID. |
titleerforderlich | string | Der Titel des Artikels.1–300 Zeichen |
content_typeoptional | string | null | blog_post, guide, comparison, faq, how_to, listicle oder landing. |
primary_keywordoptional | string | null | Das Keyword, auf das er zielt. |
intentoptional | string | null | informational, commercial, transactional oder navigational. |
angleoptional | string | null | Was der Artikel abdecken soll. |
rationaleoptional | string | null | Warum er geschrieben werden sollte. |
volumeoptional | string | null | |
difficultyoptional | string | null | |
source_langoptional | string | Die Sprache, in der der Text geschrieben ist (z. B. "fr", "en"). Ohne Angabe: die Inhaltssprache der Website.2–5 Zeichen |
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
/sites/{siteId}/content-ideas/{ideaId}KostenlosEine Content-Idee von der Website entfernen.
MCP-Tool delete_content_idea
| Argument | Typ | Beschreibung |
|---|---|---|
siteIdim Pfad | string | Die ID. |
ideaIdim Pfad | string | Die ID. |
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.

