DocumentationRéférence de l'API

Idées de contenu

Les idées de contenu d'un site : les lister, les ajouter et les supprimer.

Chaque opération ci-dessous est aussi un outil MCP, sous le même nom. Les opérations marquées Gratuit ne coûtent rien ; celles marquées Facturé utilisent les crédits de l'espace, comme dans l'app (Ce que ça coûte).

OpérationAppel
Lister les idées de contenuGET /sites/{siteId}/content-ideasGratuit
Ajouter une idée de contenuPOST /sites/{siteId}/content-ideasGratuit
Supprimer une idée de contenuDELETE /sites/{siteId}/content-ideas/{ideaId}Gratuit

Lister les idées de contenu

GET/sites/{siteId}/content-ideasGratuit

Les idées de contenu du site : des articles à écrire, chacun avec son mot-clé, son angle et sa justification.

  • Le texte est renvoyé tel qu'il est enregistré, dans la langue où il a été écrit (source_lang ; null = la langue du contenu du site). L'app le traduit à l'affichage ; l'API non.

Outil MCP list_content_ideas

ArgumentTypeDescription
siteIddans le cheminstringSon identifiant.
Requête
curl https://app.semchat.io/api/v1/sites/{siteId}/content-ideas \
  -H "Authorization: Bearer sk_live_…"
Réponse · 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"
    }
  ]
}

Ajouter une idée de contenu

POST/sites/{siteId}/content-ideasGratuit

Ajouter une idée de contenu au site.

  • Ajoutée comme idée manuelle. Renvoie l'idée.

Outil MCP add_content_idea

ArgumentTypeDescription
siteIddans le cheminstringSon identifiant.
titleobligatoirestringLe titre de l'article.1–300 caractères
content_typefacultatifstring | nullblog_post, guide, comparison, faq, how_to, listicle ou landing.
primary_keywordfacultatifstring | nullLe mot-clé qu'il vise.
intentfacultatifstring | nullinformational, commercial, transactional ou navigational.
anglefacultatifstring | nullCe que l'article doit couvrir.
rationalefacultatifstring | nullPourquoi l'écrire.
volumefacultatifstring | null
difficultyfacultatifstring | null
source_langfacultatifstringLa langue dans laquelle le texte est écrit (par ex. "fr", "en"). Omise : la langue du contenu du site.2–5 caractères
Requête
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": "…"}'

Répond 201 avec { "data": … }.

Supprimer une idée de contenu

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

Retirer une idée de contenu du site.

Outil MCP delete_content_idea

ArgumentTypeDescription
siteIddans le cheminstringSon identifiant.
ideaIddans le cheminstringSon identifiant.
Requête
curl -X DELETE https://app.semchat.io/api/v1/sites/{siteId}/content-ideas/{ideaId} \
  -H "Authorization: Bearer sk_live_…"

Répond 204 avec { "data": … }.

Une question sans réponse ici ? Écrivez-nous.

Prêt à faire décoller votre site ?

Posez votre première question - semchat vous répond avec un plan d'action clair, en quelques secondes.

Gratuit · sans inscription · en 5 secondes