DocumentaciónAPI y MCP

Primeros pasos con la API

Crea una clave, haz tu primera llamada y lee las respuestas.

Todo lo que haces en semchat, desde tu propio código (la API) o desde tu asistente de IA (MCP): tus sitios, su análisis, los planes de acción, las palabras clave, los competidores, los enlaces entrantes, los documentos, las tareas programadas y el chat de semchat. Las mismas acciones que en la aplicación, a los mismos precios.

Obtener una clave

  1. 1Abre Ajustes → API y MCPEn tu espacio, en semchat. Solo el propietario y los administradores crean y revocan claves.
  2. 2Crea una clavePonle un nombre y cópiala: solo se muestra una vez.
  3. 3Revócala si se filtraRevocar, en la misma pestaña: la clave deja de funcionar al momento.
Una clave actúa sobre todo el espacio. Guárdala en un servidor, nunca en un sitio ni en una aplicación públicos.
Ajustes › API y MCP: las claves, el servidor MCP y la configuración para cada asistente

Autenticación

Cada petición lleva la clave en la cabecera Authorization: Bearer (o X-API-Key). La URL base es https://app.semchat.io/api/v1. Los cuerpos y las respuestas van en JSON.

curl https://app.semchat.io/api/v1/sites \
  -H "Authorization: Bearer sk_live_…"

Sin una clave válida, la respuesta es un 401: consulta Errores y límites.

Un primer sitio

Crea un sitio y lanza su análisis en la misma llamada. El análisis es de pago; needs_credits indica cuándo los créditos no han alcanzado para pagarlo.

curl -X POST https://app.semchat.io/api/v1/sites \
  -H "Authorization: Bearer sk_live_…" \
  -H "Content-Type: application/json" \
  -d '{"name": "My shop", "site_url": "https://myshop.com", "auto_analyze": true}'

Después, lee su plan de acción con Listar las tareas, o pregunta al chat sobre él con Enviar un mensaje en un sitio.

Respuestas

  • Una respuesta es { "data": … }: un objeto, o una lista con todos los elementos.
  • Las fechas van en ISO 8601 en UTC, y los ids son UUID.
  • Los créditos nunca aparecen como cifras brutas, solo como porcentaje del periodo: Obtener el espacio, Obtener el uso.

Qué puede ver una clave

Una clave pertenece a un espacio: ve los sitios y las conversaciones de ese espacio y nada más, y actúa con los permisos del miembro que la creó.

El documento OpenAPI

Toda la referencia en OpenAPI 3.1, para importarla en Postman, Insomnia o un generador de clientes: openapi.json.

¿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