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

OperazioneChiamata
Elenca le idee di contenutoGET /sites/{siteId}/content-ideasGratis
Aggiungi un'idea di contenutoPOST /sites/{siteId}/content-ideasGratis
Elimina un'idea di contenutoDELETE /sites/{siteId}/content-ideas/{ideaId}Gratis

Elenca le idee di contenuto

GET/sites/{siteId}/content-ideasGratis

Le 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

ArgomentoTipoDescrizione
siteIdnel percorsostringIl suo id.
Richiesta
curl https://app.semchat.io/api/v1/sites/{siteId}/content-ideas \
  -H "Authorization: Bearer sk_live_…"
Risposta · 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"
    }
  ]
}

Aggiungi un'idea di contenuto

POST/sites/{siteId}/content-ideasGratis

Aggiungi un'idea di contenuto al sito.

  • Aggiunta come idea manuale. Risponde con l'idea.

Strumento MCP add_content_idea

ArgomentoTipoDescrizione
siteIdnel percorsostringIl suo id.
titleobbligatoriostringIl titolo dell'articolo.1–300 caratteri
content_typefacoltativostring | nullblog_post, guide, comparison, faq, how_to, listicle o landing.
primary_keywordfacoltativostring | nullLa parola chiave a cui punta.
intentfacoltativostring | nullinformational, commercial, transactional o navigational.
anglefacoltativostring | nullCosa deve trattare l'articolo.
rationalefacoltativostring | nullPerché scriverlo.
volumefacoltativostring | null
difficultyfacoltativostring | null
source_langfacoltativostringLa lingua in cui è scritto il testo (per es. "fr", "en"). Se omesso: la lingua dei contenuti del sito.2–5 caratteri
Richiesta
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

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

Rimuovi un'idea di contenuto dal sito.

Strumento MCP delete_content_idea

ArgomentoTipoDescrizione
siteIdnel percorsostringIl suo id.
ideaIdnel percorsostringIl suo id.
Richiesta
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.

Pronto a far decollare il tuo sito?

Fai la tua prima domanda - semchat ti risponde con un piano d'azione chiaro in pochi secondi.

Gratis · senza registrazione · in 5 secondi