Cómo publicar en Instagram por API: Guía paso a paso con Zoosial
2 de noviembre de 2026 · Equipo Zoosial
Para publicar en Instagram por API con Zoosial, debes enviar una solicitud HTTP POST al endpoint /posts utilizando una clave de API válida y especificando el identificador de la cuenta de Instagram, el contenido del texto y las URLs de las imágenes o videos que deseas subir.
Autenticación y configuración inicial en Zoosial
Para autenticar tus peticiones en Zoosial, debes incluir el encabezado Authorization con tu clave de API en formato Bearer token.
Tu API key en el encabezado Authorization
Cada petición a la API de Zoosial lleva la API key de tu cuenta en el encabezado Authorization, con el formato Bearer. La clave empieza con sk_live_.
Authorization: Bearer sk_live_tu_clave_aqui
Conexión de cuentas de Instagram Profesional
Instagram requiere que las cuentas utilizadas para publicación automatizada sean de tipo profesional, clasificadas ya sea como cuentas de negocio o de creador. La conexión de estos perfiles se gestiona a través del inicio de sesión oficial de Meta integrado en Zoosial. Cabe destacar que cada perfil conectado tiene asociada una sola cuenta de Instagram, y puedes realizar este enlace con o sin una página de Facebook vinculada.
Facebook solo permite publicar en páginas, no en perfiles personales. En Instagram necesitas una cuenta profesional (negocio o creador).
Cómo subir imágenes y videos a Zoosial antes de publicar
Para publicar contenido multimedia en Instagram con Zoosial, puedes subir tus archivos directamente a nuestra API u hospedar las imágenes en un servidor público.
Subida de imágenes mediante POST /upload
Para imágenes, envía un JSON con filename y base64 a POST /upload. Este método admite imágenes de hasta 5 MB. La respuesta trae una url que pasas en mediaUrls.
Envío de videos con bytes crudos
Para video, manda los bytes crudos del archivo en el cuerpo de una petición POST /upload?filename=video.mp4. La respuesta trae la url para mediaUrls.
Uso de archivos con URLs públicas existentes
Si el archivo ya tiene una URL pública, úsala directo en mediaUrls y te saltas la subida.
Publicación inmediata y programación de posts mediante POST /posts
La publicación en Instagram por API se realiza enviando una petición POST al endpoint /posts con los identificadores de cuenta, contenido y archivos correspondientes.
Cuando necesitas que tu contenido se comparta de forma inmediata en Instagram, debes realizar una llamada POST al endpoint /posts especificando los parámetros de la cuenta de destino en una lista de identificadores, el cuerpo del mensaje y los enlaces de los archivos multimedia. Al omitir la propiedad de fecha programada en el cuerpo del JSON, el sistema interpreta que la acción debe ejecutarse al momento.
{
"platforms": [{ "accountId": "id_de_tu_cuenta_de_instagram" }],
"content": "Tu texto de publicación aquí #Zoosial",
"mediaUrls": ["https://tuservidor.com/imagen.jpg"],
"publishNow": true
}
Programación de publicaciones con scheduledFor
Para programar una publicación, agrega scheduledFor con una fecha en formato ISO. Sin scheduledFor, la publicación sale al momento.
Una publicación, varias redes
Una misma publicación puede salir en Facebook, Instagram, TikTok, YouTube, LinkedIn, Google Business Profile y X (en X se publica solo texto, con la app de X de tu propia cuenta). Threads y Pinterest están en camino y todavía no están disponibles.
Gestión de publicaciones, historial y webhooks de eventos
Historial y cancelación
GET /posts lista el historial de publicaciones; el limit por defecto es 6.
Para cancelar una publicación programada, envía DELETE /posts/:id con el identificador del post.
Configuración de Webhooks de estado
Zoosial avisa a tu sistema por webhook; los principales eventos son:
- post.scheduled: se emite cuando la publicación queda programada.
- post.published: se emite cuando la publicación se publica.
- post.failed: se emite cuando la publicación falla.
Agentes de IA con MCP
Zoosial incluye un servidor MCP: un agente como Claude, ChatGPT o Codex puede programar publicaciones. Más detalles en zoosial.com/producto/mcp-agentes-ia.
Precios de Zoosial en México
Los precios van en pesos mexicanos más IVA. El plan gratis incluye 1 perfil con hasta 3 cuentas conectadas, con publicar y programar. La prueba de 14 días trae 1 perfil con todas las redes y 100 créditos de IA, sin tarjeta. El plan por perfil cuesta $95 MXN al mes + IVA por perfil, y el primer perfil no se cobra; el precio baja por tramos con más perfiles. Consulta el detalle en zoosial.com/pricing (precios revisados el 1 de noviembre de 2026).
La documentación completa está en zoosial.com/docs.
Más información:
- zoosial.com/producto/publicar-redes-sociales
- zoosial.com/pricing
- zoosial.com/producto/api-webhooks
- zoosial.com/docs
- zoosial.com/llms.txt
Preguntas Frecuentes
¿Qué tipo de cuentas de Instagram se pueden usar con la API de Zoosial?
Se requiere una cuenta profesional, ya sea de tipo negocio o creador. Puedes conectarla mediante el inicio de sesión oficial de Meta integrado en Zoosial, con o sin una página de Facebook asociada.
¿Cuáles son los límites de peso para subir imágenes a la API de Zoosial?
Al utilizar el endpoint POST /upload enviando los datos codificados en formato JSON con base64, el tamaño máximo permitido para archivos de imagen es de 5 MB.
¿Cuánto cuesta utilizar el servicio de Zoosial en México?
Zoosial tiene un plan gratis con 1 perfil y hasta 3 cuentas conectadas. El plan por perfil cuesta $95 MXN al mes + IVA por perfil, y el primero no se cobra. Detalle en zoosial.com/pricing.
¿Cómo se cancela una publicación programada en la API?
Puedes anular cualquier publicación programada que aún no se haya publicado realizando una solicitud HTTP DELETE al endpoint /posts/:id usando el identificador único del post.