DocumentazioneRiferimento API
Idee di contenuto
Le idee di contenuto di un sito: elencarle, aggiungerle ed eliminarle.
Ogni operazione qui sotto è anche uno strumento MCP, con lo stesso nome. Le operazioni Gratis non costano nulla; quelle A pagamento usano i crediti dello spazio di lavoro, come nell'app (Quanto costa).
| Operazione | Chiamata | |
|---|---|---|
| Elenca le idee di contenuto | GET /sites/{siteId}/content-ideas | Gratis |
| Aggiungi un'idea di contenuto | POST /sites/{siteId}/content-ideas | Gratis |
| Elimina un'idea di contenuto | DELETE /sites/{siteId}/content-ideas/{ideaId} | Gratis |
Elenca le idee di contenuto
/sites/{siteId}/content-ideasGratisLe idee di contenuto del sito: articoli da scrivere, ognuno con la sua parola chiave, la sua angolazione e la sua motivazione.
- Il testo viene restituito così com'è salvato, nella lingua in cui è stato scritto (source_lang; null = la lingua dei contenuti del sito). L'app lo traduce quando lo mostra; l'API no.
Strumento MCP list_content_ideas
| Argomento | Tipo | Descrizione |
|---|---|---|
siteIdnel percorso | string | Il suo 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"
}
]
}Aggiungi un'idea di contenuto
/sites/{siteId}/content-ideasGratisAggiungi un'idea di contenuto al sito.
- Aggiunta come idea manuale. Risponde con l'idea.
Strumento MCP add_content_idea
| Argomento | Tipo | Descrizione |
|---|---|---|
siteIdnel percorso | string | Il suo id. |
titleobbligatorio | string | Il titolo dell'articolo.1–300 caratteri |
content_typefacoltativo | string | null | blog_post, guide, comparison, faq, how_to, listicle o landing. |
primary_keywordfacoltativo | string | null | La parola chiave a cui punta. |
intentfacoltativo | string | null | informational, commercial, transactional o navigational. |
anglefacoltativo | string | null | Cosa deve trattare l'articolo. |
rationalefacoltativo | string | null | Perché scriverlo. |
volumefacoltativo | string | null | |
difficultyfacoltativo | string | null | |
source_langfacoltativo | string | La lingua in cui è scritto il testo (per es. "fr", "en"). Se omesso: la lingua dei contenuti del sito.2–5 caratteri |
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": "…"}'Risponde 201 con { "data": … }.
Elimina un'idea di contenuto
/sites/{siteId}/content-ideas/{ideaId}GratisRimuovi un'idea di contenuto dal sito.
Strumento MCP delete_content_idea
| Argomento | Tipo | Descrizione |
|---|---|---|
siteIdnel percorso | string | Il suo id. |
ideaIdnel percorso | string | Il suo id. |
curl -X DELETE https://app.semchat.io/api/v1/sites/{siteId}/content-ideas/{ideaId} \
-H "Authorization: Bearer sk_live_…"Risponde 204 con { "data": … }.
Hai una domanda a cui qui non trovi risposta? Scrivici.

