API REST

La API REST de Fuxux: claves de API, los endpoints principales de publicaciones, cuentas y archivos, webhooks firmados y límites de peticiones.

La API REST cubre lo que la app web hace con las publicaciones: crearlas, programarlas, listarlas, editarlas y eliminarlas, subir archivos, leer las cuentas conectadas y las analíticas, y generar textos. La referencia interactiva está en /reference y el documento OpenAPI en /openapi.json.

¿Usas Cursor, Claude Code u otro asistente de programación con el servidor MCP de Context7? Esta documentación está indexada allí: añade use context7 a tu prompt o pide la biblioteca /llmstxt/fuxux_llms_txt (Fuxux en Context7). La referencia de la API también está indexada, como Fuxux API.

¿Comparando APIs de publicación? Consulta Fuxux como alternativa a Ayrshare para ver precios y para qué está pensada cada una.

URL base y autenticación

https://www.fuxux.com/api

Envía una clave de API como token bearer. Las claves vienen con todos los planes de pago (Creator, Growth o Pro), sin coste adicional. Créalas en la página API keys: empiezan por fx_live_, se muestran una sola vez y duran hasta que las revocas o las rotas. Usa una clave por integración.

curl https://www.fuxux.com/api/accounts \
  -H "Authorization: Bearer fx_live_your_key_here"

Endpoints principales

Método y ruta	Qué hace
`GET /api/accounts`	Lista las cuentas sociales conectadas.
`GET /api/posts`	Lista publicaciones (filtra por estado y mes).
`POST /api/posts`	Crea una publicación: publica ahora, prográmala o guarda un borrador.
`GET /api/posts/{id}`	Una publicación con los resultados por plataforma.
`PATCH /api/posts/{id}`	Edita o reprograma un borrador o una publicación programada.
`DELETE /api/posts/{id}`	Elimina una publicación.
`POST /api/media/upload`	Sube una imagen o un vídeo para adjuntarlo a publicaciones.
`POST /api/ai/generate`	Genera un texto para cada plataforma a partir de un prompt.
`GET /api/usage`	Los límites de tu plan y lo que has usado este mes.
`GET /api/analytics`	Analíticas de publicación.
`GET /api/dashboard`	Resumen: recuentos, próximas publicaciones y cuentas que necesitan atención.

Crear una publicación

curl -X POST https://www.fuxux.com/api/posts \
  -H "Authorization: Bearer fx_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "captions": {
      "linkedin": "We just shipped RSS auto-posting: every new blog post now shares itself.",
      "bluesky": "RSS auto-posting is live."
    },
    "scheduled_at": "2026-11-02T09:00:00Z"
  }'

captions asigna a cada id de plataforma su texto; la publicación va a la primera cuenta conectada de cada plataforma, o a las cuentas que indiques en targets. Omite scheduled_at para publicar ahora, o envía draft: true para guardar un borrador. Adjunta archivos con media_urls de POST /api/media/upload. Todos los campos están en la referencia de la API.

Webhooks

Define una URL de webhook en la página API keys para recibir un POST cuando una publicación sale o falla. Cada petición va firmada: la cabecera X-Fuxux-Signature es sha256= seguido del HMAC-SHA256 del cuerpo sin procesar con tu secreto de webhook. Compruébala antes de fiarte del contenido.

Límites de peticiones y errores

120 peticiones por minuto por clave, 300 por minuto por cuenta entre todas las claves. Una respuesta 429 indica cuándo reintentar.
Los errores devuelven JSON con un mensaje error que explica qué cambiar (por ejemplo, un texto que supera el límite de una red o un límite del plan alcanzado).

Ver en Markdown (en inglés)