DocumentaciónReferencia de la API

Ideas de contenido

Las ideas de contenido de un sitio: listarlas, añadirlas y eliminarlas.

Cada operación de esta página es también una herramienta MCP, con el mismo nombre. Las marcadas Gratis no cuestan nada; las marcadas De pago usan los créditos del espacio, como en la aplicación (Cuánto cuesta).

OperaciónLlamada
Listar las ideas de contenidoGET /sites/{siteId}/content-ideasGratis
Añadir una idea de contenidoPOST /sites/{siteId}/content-ideasGratis
Eliminar una idea de contenidoDELETE /sites/{siteId}/content-ideas/{ideaId}Gratis

Listar las ideas de contenido

GET/sites/{siteId}/content-ideasGratis

Las ideas de contenido del sitio: artículos por escribir, cada uno con su palabra clave, su enfoque y su justificación.

  • El texto se devuelve tal como está guardado, en el idioma en que se escribió (source_lang; null = el idioma del contenido del sitio). La aplicación lo traduce al mostrarlo; la API no.

Herramienta MCP list_content_ideas

ArgumentoTipoDescripción
siteIden la rutastringSu id.
Petición
curl https://app.semchat.io/api/v1/sites/{siteId}/content-ideas \
  -H "Authorization: Bearer sk_live_…"
Respuesta · 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"
    }
  ]
}

Añadir una idea de contenido

POST/sites/{siteId}/content-ideasGratis

Añade una idea de contenido al sitio.

  • Se añade como idea manual. Responde con la idea.

Herramienta MCP add_content_idea

ArgumentoTipoDescripción
siteIden la rutastringSu id.
titleobligatoriostringEl título del artículo.1–300 caracteres
content_typeopcionalstring | nullblog_post, guide, comparison, faq, how_to, listicle o landing.
primary_keywordopcionalstring | nullLa palabra clave a la que apunta.
intentopcionalstring | nullinformational, commercial, transactional o navigational.
angleopcionalstring | nullLo que debe tratar el artículo.
rationaleopcionalstring | nullPor qué escribirlo.
volumeopcionalstring | null
difficultyopcionalstring | null
source_langopcionalstringEl idioma en que está escrito el texto (p. ej. "fr", "en"). Si se omite: el idioma del contenido del sitio.2–5 caracteres
Petición
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 con { "data": … }.

Eliminar una idea de contenido

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

Quita una idea de contenido del sitio.

Herramienta MCP delete_content_idea

ArgumentoTipoDescripción
siteIden la rutastringSu id.
ideaIden la rutastringSu id.
Petición
curl -X DELETE https://app.semchat.io/api/v1/sites/{siteId}/content-ideas/{ideaId} \
  -H "Authorization: Bearer sk_live_…"

Responde 204 con { "data": … }.

¿No encuentras la respuesta? Escríbenos.

¿Listo para impulsar tu web?

Haz tu primera pregunta - semchat te responde con un plan de acción claro en segundos.

Gratis · sin registro · en 5 segundos