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çãoChamada
Listar as ideias de conteúdoGET /sites/{siteId}/content-ideasGrátis
Adicionar uma ideia de conteúdoPOST /sites/{siteId}/content-ideasGrátis
Excluir uma ideia de conteúdoDELETE /sites/{siteId}/content-ideas/{ideaId}Grátis

Listar as ideias de conteúdo

GET/sites/{siteId}/content-ideasGrátis

As 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

ArgumentoTipoDescrição
siteIdno caminhostringO id dele.
Requisição
curl https://app.semchat.io/api/v1/sites/{siteId}/content-ideas \
  -H "Authorization: Bearer sk_live_…"
Resposta · 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"
    }
  ]
}

Adicionar uma ideia de conteúdo

POST/sites/{siteId}/content-ideasGrátis

Adiciona uma ideia de conteúdo ao site.

  • Adicionada como ideia manual. Responde com a ideia.

Ferramenta MCP add_content_idea

ArgumentoTipoDescrição
siteIdno caminhostringO id dele.
titleobrigatóriostringO título do artigo.1–300 caracteres
content_typeopcionalstring | nullblog_post, guide, comparison, faq, how_to, listicle ou landing.
primary_keywordopcionalstring | nullA palavra-chave que ele mira.
intentopcionalstring | nullinformational, commercial, transactional ou navigational.
angleopcionalstring | nullO que o artigo deve abordar.
rationaleopcionalstring | nullPor que escrevê-lo.
volumeopcionalstring | null
difficultyopcionalstring | null
source_langopcionalstringO idioma em que o texto está escrito (por exemplo "fr", "en"). Se omitido: o idioma do conteúdo do site.2–5 caracteres
Requisição
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

DELETE/sites/{siteId}/content-ideas/{ideaId}Grátis

Remove uma ideia de conteúdo do site.

Ferramenta MCP delete_content_idea

ArgumentoTipoDescrição
siteIdno caminhostringO id dele.
ideaIdno caminhostringO id dele.
Requisição
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.

Pronto para fazer seu site decolar?

Faça sua primeira pergunta - o semchat responde com um plano de ação claro em segundos.

Grátis · sem cadastro · em 5 segundos