API REST

Programa posts desde tu código

Una API REST para Instagram, LinkedIn, X, TikTok, Pinterest, Threads, Facebook, Bluesky y Mastodon. OpenAPI en /api/openapi.json. Auth con una API key en el header x-api-key.

Empieza gratis Servidor MCP

POST /api/posts

curl -X POST https://socialrobot.io/api/posts \
  -H "x-api-key: $SOCIALROBOT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "content": "Ya está el flat white de avena.",
    "scheduledAt": "2026-08-01T09:00:00Z",
    "targets": [
      { "platform": "instagram", "accountId": "acc_123" },
      { "platform": "linkedin",  "accountId": "acc_456" },
      { "platform": "x",         "accountId": "acc_789" }
    ]
  }'

Cuentas que ya vinculaste en la app

X (Twitter)InstagramBlueskyLinkedInPinterestMastodonThreadsFacebookTikTok

Qué cubre

El mismo motor que el panel

Si funciona en SocialRobot, lo puedes disparar por HTTP. Los posts llegan al calendario como si los hubieras escrito a mano.

POST /posts

POST /posts

Una petición, varios destinos. Cambia el texto por red cuando haga falta.

PATCH /posts/{id}/schedule

Programar y mover

Pon una hora. Muévela después. O borra el borrador.

POST /media/upload-url

Subida de medios

Sube imágenes y vídeo como en la app. Si tu script no puede subir el archivo, envía una URL pública de la imagen.

GET /pinterest/boards/{accountId}

Extras por red

Tableros de Pinterest, info de creador de TikTok y las mismas opciones que ya ves en el compositor.

Configuración

Tres pasos y luego curl

No registras apps de Meta o LinkedIn tú. SocialRobot ya tiene esas conexiones.

Vincula cuentas en la app

Conecta Instagram, LinkedIn y el resto en Scheduler → Cuentas. La API publica con esos logins.

Crea una API key

Ajustes del Scheduler → API keys. Cópiala una vez y envíala como x-api-key (Bearer también vale).

Llama a los endpoints

GET /accounts para los IDs y luego POST /posts con contenido, horario y destinos.

Docs y límites

Lo que tienes desde el día uno

/api/openapi.json

OpenAPI 3

Spec completa en /api/openapi.json. Ábrela en Postman o genera un cliente a partir de ella.

x-api-key: sk_…

API keys

Auth servidor a servidor sin una app OAuth aparte. Crea, acota y revoca keys en el panel.

2,000 req/min

Límites

2.000 peticiones/minuto por cuenta y 200.000/día, compartidos con MCP. Mismos techos en Free y de pago.

¿Prefieres pedírselo a Claude que escribir curl?

La misma publicación. Añade https://socialrobot.io/api/mcp a ChatGPT, Claude o Cursor e inicia sesión.

Ver cómo

¿Ya estás en n8n?

Nodo verificado de SocialRobot. Búscalo en el panel de nodos, pon tu API key y publica en las mismas nueve redes.

Setup de n8n

Un servidor MCP. Tus redes sociales.

Elige una red para ver formatos, requisitos de cuenta, ejemplos y configuración. Todas se conectan al mismo servidor de SocialRobot.

Servidor MCP de Instagram

Fotos, carruseles, Reels, Historias, primer comentario y estadísticas.

Conectar Instagram

Servidor MCP de Pinterest

Programación de Pines, tableros, enlaces y analíticas de mejores Pines.

Conectar Pinterest

X requiere Pro

Servidor MCP de X (Twitter)

Texto, imágenes, vídeo e hilos conectados. Disponible en Pro.

Conectar X (Twitter)

Servidor MCP de LinkedIn

Perfiles, Páginas de empresa, documentos, encuestas y analíticas.

Conectar LinkedIn

Servidor MCP de Bluesky

Texto, fotos, vídeo y programación junto a tus otras redes.

Conectar Bluesky

Servidor MCP de TikTok

Vídeos, presentaciones de fotos, opciones del creador y borradores en TikTok.

Conectar TikTok

Servidor MCP de Mastodon

Conexión con tu servidor, visibilidad, avisos, texto alternativo y encuestas.

Conectar Mastodon

Servidor MCP de Meta Threads

Texto, archivos, hilos de hasta 20 posts y estadísticas.

Conectar Meta Threads

Servidor MCP de Facebook

Publicación en Páginas, posts programados y estadísticas.

Conectar Facebook

FAQ

¿Cómo me autentico?

Crea una API key en el panel y envíala como x-api-key, o como Authorization: Bearer. No hace falta otra app OAuth para scripts de servidor.

¿Cuáles son los rate limits?

HTTP y MCP comparten 2.000 peticiones/minuto por cuenta y 200.000/día. Las llamadas de handshake MCP como initialize y resources/read no cuentan.

¿Dónde está el OpenAPI?

https://socialrobot.io/api/openapi.json. Los usuarios con sesión también tienen docs interactivas dentro de la app.

¿REST, MCP o n8n?

Usa REST cuando tu código llama a la API. Usa MCP cuando ChatGPT, Claude o Cursor deban llamar tools después de que apruebes el acceso. Usa el nodo de n8n cuando el trigger sea una hoja, un feed RSS u otra app en el canvas.