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
- 1Abre Ajustes → API y MCPEn tu espacio, en semchat. Solo el propietario y los administradores crean y revocan claves.
- 2Crea una clavePonle un nombre y cópiala: solo se muestra una vez.
- 3Revócala si se filtraRevocar, en la misma pestaña: la clave deja de funcionar al momento.
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.

