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).

OperationCall
List content ideasGET /sites/{siteId}/content-ideasFree
Add content ideaPOST /sites/{siteId}/content-ideasFree
Delete content ideaDELETE /sites/{siteId}/content-ideas/{ideaId}Free

List content ideas

GET/sites/{siteId}/content-ideasFree

The 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

ArgumentTypeDescription
siteIdin the pathstringIts 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-ideasFree

Add a content idea to the site.

  • Added as a manual idea. Answers the idea.

MCP tool add_content_idea

ArgumentTypeDescription
siteIdin the pathstringIts id.
titlerequiredstringThe article’s title.1–300 characters
content_typeoptionalstring | nullblog_post, guide, comparison, faq, how_to, listicle or landing.
primary_keywordoptionalstring | nullThe keyword it targets.
intentoptionalstring | nullinformational, commercial, transactional or navigational.
angleoptionalstring | nullWhat the article should cover.
rationaleoptionalstring | nullWhy write it.
volumeoptionalstring | null
difficultyoptionalstring | null
source_langoptionalstringThe 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}Free

Remove a content idea from the site.

MCP tool delete_content_idea

ArgumentTypeDescription
siteIdin the pathstringIts id.
ideaIdin the pathstringIts 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.

Ready to get your site off the ground?

Ask your first question - semchat replies with a clear action plan in seconds.

Free · no sign-up · takes 5 seconds