DocumentaçãoReferência da API
Ideias de conteúdo
As ideias de conteúdo de um site: listar, adicionar e excluir.
Cada operação abaixo também é uma ferramenta MCP, com o mesmo nome. As operações marcadas Grátis não custam nada; as marcadas Cobrado usam os créditos do espaço de trabalho, como no aplicativo (Quanto custa).
| Operação | Chamada | |
|---|---|---|
| Listar as ideias de conteúdo | GET /sites/{siteId}/content-ideas | Grátis |
| Adicionar uma ideia de conteúdo | POST /sites/{siteId}/content-ideas | Grátis |
| Excluir uma ideia de conteúdo | DELETE /sites/{siteId}/content-ideas/{ideaId} | Grátis |
Listar as ideias de conteúdo
/sites/{siteId}/content-ideasGrátisAs ideias de conteúdo do site: artigos para escrever, cada um com a palavra-chave, o ângulo e a justificativa.
- O texto volta como está salvo, no idioma em que foi escrito (source_lang; null = o idioma do conteúdo do site). O aplicativo traduz o texto na exibição; a API não.
Ferramenta MCP list_content_ideas
| Argumento | Tipo | Descrição |
|---|---|---|
siteIdno caminho | string | O id dele. |
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"
}
]
}Adicionar uma ideia de conteúdo
/sites/{siteId}/content-ideasGrátisAdiciona uma ideia de conteúdo ao site.
- Adicionada como ideia manual. Responde com a ideia.
Ferramenta MCP add_content_idea
| Argumento | Tipo | Descrição |
|---|---|---|
siteIdno caminho | string | O id dele. |
titleobrigatório | string | O título do artigo.1–300 caracteres |
content_typeopcional | string | null | blog_post, guide, comparison, faq, how_to, listicle ou landing. |
primary_keywordopcional | string | null | A palavra-chave que ele mira. |
intentopcional | string | null | informational, commercial, transactional ou navigational. |
angleopcional | string | null | O que o artigo deve abordar. |
rationaleopcional | string | null | Por que escrevê-lo. |
volumeopcional | string | null | |
difficultyopcional | string | null | |
source_langopcional | string | O idioma em que o texto está escrito (por exemplo "fr", "en"). Se omitido: o idioma do conteúdo do site.2–5 caracteres |
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": "…"}'Responde 201 com { "data": … }.
Excluir uma ideia de conteúdo
/sites/{siteId}/content-ideas/{ideaId}GrátisRemove uma ideia de conteúdo do site.
Ferramenta MCP delete_content_idea
| Argumento | Tipo | Descrição |
|---|---|---|
siteIdno caminho | string | O id dele. |
ideaIdno caminho | string | O id dele. |
curl -X DELETE https://app.semchat.io/api/v1/sites/{siteId}/content-ideas/{ideaId} \
-H "Authorization: Bearer sk_live_…"Responde 204 com { "data": … }.
Não encontrou a resposta? Fale com a gente.

