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.

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": "New oat flat white is live.",
    "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

XX (Twitter)InstagramInstagramBlueskyBlueskyLinkedInPinterestPinterestMastodonMastodonThreadsThreadsFacebookFacebookTikTokTikTok
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

Una petición, varios destinos. Puedes cambiar el caption por red cuando haga falta.

Programar y mover

Pon scheduledAt, cámbialo después con PATCH, o borra borradores y posts en cola.

Subida de medios

Pide una URL prefirmada, haz PUT del archivo y adjúntalo al post. Imágenes y video.

Extras por red

Tableros de Pinterest, info de creador de TikTok y otros endpoints que ya usa el compositor.

Configuración

Tres pasos y luego curl

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

1

Vincula cuentas en la app

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

2

Crea una API key

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

3

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

OpenAPI 3

Spec completa en /api/openapi.json. Impórtala en Postman, Insomnia o tu codegen.

API keys

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

Rate limits

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

¿Prefieres Claude o Cursor a curl?

La misma superficie de publicación como servidor MCP. Apunta tu cliente a https://socialrobot.io/api/mcp e inicia sesión.

n8n

¿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.

FAQ

Saca una key y haz POST /posts

Regístrate, conecta las cuentas donde publicas, crea una API key y programa desde tu script.

Consigue una API key