Publicar en Facebook, Instagram y YouTube con una sola llamada a la API

28 de octubre de 2026 · Equipo Zoosial

Con la API de Zoosial publicas en varias redes con un solo POST /posts: mandas el texto, la lista de cuentas donde debe salir y, si quieres programarlo, una fecha en scheduledFor. Sin fecha, publica al momento. Es la misma llamada para Facebook, Instagram y YouTube, usando las APIs oficiales de cada red.

Lo que necesitas

1. Una cuenta de Zoosial y una API key (en el panel, en API Keys; se ve una sola vez).
2. Las cuentas conectadas desde el panel con el inicio de sesión oficial de cada red. Facebook se conecta con páginas; Instagram, con cuentas profesionales.
3. El accountId de cada cuenta donde quieres publicar.

La llamada

La key va en la cabecera Authorization:

curl -X POST https://zoosial.com/posts \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "platforms": [{"accountId": "acc_facebook"}, {"accountId": "acc_instagram"}],
    "content": "Nuevo lanzamiento disponible esta semana.",
    "mediaUrls": ["https://ejemplo.com/foto.jpg"]
  }'

Los identificadores del ejemplo son ilustrativos: usa los de tus cuentas. Los campos son platforms (las cuentas), content (texto), mediaUrls (archivos), scheduledFor (fecha ISO) y publishNow.

Programar en lugar de publicar ya

Agrega scheduledFor con una fecha y hora en formato ISO. Con una fecha futura, Zoosial emite el evento post.scheduled y publica a esa hora. Si prefieres un ritmo fijo, la API también tiene una cola con horarios recurrentes por perfil (POST /queue/slots) y POST /queue agenda la publicación en el próximo horario libre.

Subir imágenes y video

mediaUrls acepta URLs. Si ya tienes una URL pública del archivo, úsala directo. Si no, tienes tres vías:

• POST /upload con JSON (filename y base64): pensado para imágenes, porque el cuerpo tiene un límite de 5 MB.
• POST /upload?filename=video.mp4 con los bytes crudos y el Content-Type real del archivo: sin el tope de 5 MB, es la vía para video.
• POST /upload/url: Zoosial descarga el archivo desde una URL https pública.

Cada una devuelve una url que pones en mediaUrls.

Saber si salió bien

Suscribe un webhook y recibirás post.published, post.failed y post.scheduled firmados en tu servidor. También puedes consultar el historial con GET /posts (ojo: por defecto devuelve 6; pasa limit si quieres más) y cancelar una programada con DELETE /posts/:id. Detalles en la documentación de publicaciones y en API y webhooks.

Lo que debes saber

• Facebook solo permite publicar en páginas, no en perfiles personales.
• YouTube tiene acceso limitado mientras Google termina de verificar la aplicación.
• Publicar y programar viene incluido y puedes empezar gratis; mira Publicar y programar.

Si prefieres no escribir código

El servidor MCP de Zoosial expone la misma publicación como herramienta (create_post), así que un agente como Claude puede hacerlo por ti. El MCP va incluido en todos los planes. Para que un agente conozca todos los endpoints, apúntalo a /llms.txt.

Preguntas frecuentes

← Todos los artículos