Referencia de la API

Cada endpoint de la API de Marsial, generado del documento OpenAPI. Base URL: https://api.marsial.dev/v1 · Documento OpenAPI (JSON)

PublicacionesPublica ahora, programa, usa la cola o guarda borradores en una o varias cuentas. (14 endpoints)

MultimediaSube imágenes y vídeos a Marsial antes de publicarlos. (1 endpoint)

PerfilesUn perfil es una marca o un cliente final. Las cuentas sociales se conectan a un perfil. (5 endpoints)

ConexiónConecta una cuenta social o un sitio: manda al usuario a la URL y Marsial lo devuelve a tu redirectUrl. (4 endpoints)

CuentasCuentas sociales conectadas, si pueden publicar, y sus tableros, listas y subreddits. (8 endpoints)

Grupos de cuentasSelecciones de cuentas guardadas, para publicar en todas a la vez. (4 endpoints)

BlogsArtículos en sitios de WordPress, Shopify, Wix y Webflow: listar, crear borradores, programar, publicar, cambiar y borrar. Estas cuentas reciben artículos, no publicaciones. (6 endpoints)

ColaHuecos semanales por perfil. Los posts con `queue: true` toman el siguiente libre. (3 endpoints)

BandejaMensajes directos, comentarios y reseñas de las cuentas de un perfil. Los listados piden el perfil; las acciones, la cuenta a la que pertenece cada elemento. (15 endpoints)

WhatsAppNúmeros de WhatsApp Business: plantillas que revisa Meta, escribir primero con una plantilla aprobada (POST /inbox/conversations) y difusiones a muchos números. Las respuestas dentro de las 24 horas van por la bandeja. Estas cuentas no publican. (7 endpoints)

AnunciosCampañas en Meta, Google, LinkedIn, TikTok, Pinterest, X y Reddit con una conexión de anuncios (plataforma `meta-ads`, `google-ads`…): listarlas con gasto y resultados, pausar, reanudar, cambiar presupuestos, promocionar publicaciones, crear campañas y enviar conversiones. Los presupuestos van en unidades enteras de la moneda, nunca en céntimos. (9 endpoints)

Números de teléfonoNúmeros para llamadas y SMS: países y precios, comprar uno (los países que regulan los números piden antes la identidad del titular: KYC), decidir a dónde van las llamadas y activar los SMS. Los gestionan propietarios y admins; cada número se cobra al mes del saldo. (11 endpoints)

LlamadasLlama desde tus números (Marsial llama a la persona y la conecta con tu teléfono, una dirección SIP o un agente de voz con IA), lee el historial con grabaciones y transcripciones y calcula lo que cuesta una llamada. (7 endpoints)

SMSEnvía SMS y MMS desde tus números. Las respuestas llegan a la bandeja (plataforma `sms`) y como eventos `message.received`. (2 endpoints)

AutomatizacionesComentario a mensaje: a quien comente una palabra clave, se le responde con un mensaje privado (Instagram, Facebook) o en público (todas las redes). (6 endpoints)

AnalíticasSeguidores, totales diarios, mejores horas para publicar y mejores publicaciones, por perfil o por cuenta. (4 endpoints)

WebhooksRecibe los eventos de Marsial en tu endpoint HTTPS. (4 endpoints)

WorkspaceTu workspace y quién está llamando. (3 endpoints)

EquipoMiembros e invitaciones. Propietarios y admins gestionan el equipo; los miembros publican y responden. (6 endpoints)

FacturaciónUna prueba gratis y después un saldo prepago. Las cuentas nuevas publican gratis 7 días desde su primera publicación (como mucho 14 días desde el registro); X y los números de teléfono necesitan saldo. Tras la primera recarga, las cuentas conectadas se cobran día a día y el uso (API de X, mensajes, números, llamadas y SMS) según se produce. Se recarga desde el panel. (5 endpoints)

API keysGestiona las API keys. Solo desde el panel, para que una key filtrada no pueda crear otras. (3 endpoints)

Agentes IAAgentes de IA conectados por el servidor MCP (OAuth). El panel los aprueba y los desconecta; los agentes usan https://api.marsial.dev/mcp. (5 endpoints)