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ération | Appel | |
|---|---|---|
| Lister les idées de contenu | GET /sites/{siteId}/content-ideas | Gratuit |
| Ajouter une idée de contenu | POST /sites/{siteId}/content-ideas | Gratuit |
| Supprimer une idée de contenu | DELETE /sites/{siteId}/content-ideas/{ideaId} | Gratuit |
Lister les idées de contenu
/sites/{siteId}/content-ideasGratuitLes 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
| Argument | Type | Description |
|---|---|---|
siteIddans le chemin | string | Son identifiant. |
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"
}
]
}Ajouter une idée de contenu
/sites/{siteId}/content-ideasGratuitAjouter une idée de contenu au site.
- Ajoutée comme idée manuelle. Renvoie l'idée.
Outil MCP add_content_idea
| Argument | Type | Description |
|---|---|---|
siteIddans le chemin | string | Son identifiant. |
titleobligatoire | string | Le titre de l'article.1–300 caractères |
content_typefacultatif | string | null | blog_post, guide, comparison, faq, how_to, listicle ou landing. |
primary_keywordfacultatif | string | null | Le mot-clé qu'il vise. |
intentfacultatif | string | null | informational, commercial, transactional ou navigational. |
anglefacultatif | string | null | Ce que l'article doit couvrir. |
rationalefacultatif | string | null | Pourquoi l'écrire. |
volumefacultatif | string | null | |
difficultyfacultatif | string | null | |
source_langfacultatif | string | La langue dans laquelle le texte est écrit (par ex. "fr", "en"). Omise : la langue du contenu du site.2–5 caractères |
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
/sites/{siteId}/content-ideas/{ideaId}GratuitRetirer une idée de contenu du site.
Outil MCP delete_content_idea
| Argument | Type | Description |
|---|---|---|
siteIddans le chemin | string | Son identifiant. |
ideaIddans le chemin | string | Son identifiant. |
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.

