DocumentationAPI reference
Content ideas
A site’s content ideas: list, add and delete them.
Every operation below is also an MCP tool, under the same name. Free operations cost nothing; Billed ones use the workspace’s credits, as in the app (What it costs).
| Operation | Call | |
|---|---|---|
| List content ideas | GET /sites/{siteId}/content-ideas | Free |
| Add content idea | POST /sites/{siteId}/content-ideas | Free |
| Delete content idea | DELETE /sites/{siteId}/content-ideas/{ideaId} | Free |
List content ideas
GET
/sites/{siteId}/content-ideasFreeThe site’s content ideas: articles to write, each with its keyword, angle and rationale.
- Text is returned as stored, in the language it was written in (source_lang; null = the site’s content language). The app translates it on display; the API does not.
MCP tool list_content_ideas
| Argument | Type | Description |
|---|---|---|
siteIdin the path | string | Its id. |
Request
curl https://app.semchat.io/api/v1/sites/{siteId}/content-ideas \
-H "Authorization: Bearer sk_live_…"Response · 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"
}
]
}Add content idea
POST
/sites/{siteId}/content-ideasFreeAdd a content idea to the site.
- Added as a manual idea. Answers the idea.
MCP tool add_content_idea
| Argument | Type | Description |
|---|---|---|
siteIdin the path | string | Its id. |
titlerequired | string | The article’s title.1–300 characters |
content_typeoptional | string | null | blog_post, guide, comparison, faq, how_to, listicle or landing. |
primary_keywordoptional | string | null | The keyword it targets. |
intentoptional | string | null | informational, commercial, transactional or navigational. |
angleoptional | string | null | What the article should cover. |
rationaleoptional | string | null | Why write it. |
volumeoptional | string | null | |
difficultyoptional | string | null | |
source_langoptional | string | The language the text is written in (e.g. "fr", "en"). Omitted: the site’s content language.2–5 characters |
Request
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": "…"}'Answers 201 with { "data": … }.
Delete content idea
DELETE
/sites/{siteId}/content-ideas/{ideaId}FreeRemove a content idea from the site.
MCP tool delete_content_idea
| Argument | Type | Description |
|---|---|---|
siteIdin the path | string | Its id. |
ideaIdin the path | string | Its id. |
Request
curl -X DELETE https://app.semchat.io/api/v1/sites/{siteId}/content-ideas/{ideaId} \
-H "Authorization: Bearer sk_live_…"Answers 204 with { "data": … }.
A question this doesn’t answer? Write to us.

