API y MCP de Instagram: publica, responde y mide desde tu código o tu agente de IA

28 de octubre de 2026 · Equipo Zoosial

Zoosial ofrece una API REST y un servidor MCP para operar una cuenta profesional de Instagram: publicar en el feed, leer y responder comentarios y mensajes directos, mandar un mensaje privado a quien comenta una palabra clave y consultar métricas. Usa las APIs oficiales de Meta, así que sus reglas aplican.

Qué puedes hacer

• Publicar o programar una imagen o video en el feed: POST /posts. Instagram exige mediaUrls; no publica solo texto. Para subir un archivo: POST /upload.
• Historial con like_count y comments_count: GET /accounts/:id/history.
• Leer, responder y borrar comentarios: GET, POST y DELETE /accounts/:id/comments.
• Responder por mensaje privado a un comentario, con texto propio: POST /accounts/:id/comments/:commentId/private-reply.
• Leer y contestar DMs: GET /accounts/:id/conversations, GET /accounts/:id/conversations/:convId y POST /accounts/:id/messages.
• Comentario a mensaje automático (palabra clave, DM y respuesta pública opcional): POST /automations con platform: "instagram".
• Métricas: GET /accounts/:id/insights, GET /accounts/:id/post-insights?objectId= y GET /analytics/:accountId/summary.

Cómo conectar la cuenta

No existe un /connect/instagram aparte: Instagram se conecta junto con la Página de Facebook a la que está vinculado, y queda en GET /accounts como cuenta independiente.

1. Crea un perfil con POST /profiles y guarda su id.
2. Si construyes tu propia app, registra tu redirectUri en tu API key (localhost no lo necesita) y llama POST /connect/sessions con profileId, platform: "meta", redirectUri, clientState y endUserId. Devuelve una url de un solo uso que caduca en 10 minutos; ábrela en el navegador de tu usuario.
3. Tras autorizar, Meta vuelve a tu redirectUri con un ct que vale 15 minutos. Con él, GET /profiles/:id/connect/meta/available?ct= lista las Páginas y POST /profiles/:id/connect/meta con { ct, pageId } conecta una junto con su Instagram.

Para uso interactivo directo, GET /connect/meta?profileId=… devuelve el authUrl. Más en Instagram.

Ejemplo

Publicar una foto ahora mismo:

curl -X POST https://zoosial.com/posts \
  -H "Authorization: Bearer $SC_API_KEY" -H "Content-Type: application/json" \
  -d '{"platforms":[{"accountId":"acc_ig_1"}],"content":"Nuevo post","mediaUrls":["https://cdn.../foto.jpg"],"publishNow":true}'

Por MCP

El servidor MCP está en https://zoosial.com/mcp y se autoriza con tu cuenta, sin pegar llaves. Estas son las herramientas que aplican a Instagram:

• Publicar: create_post, list_posts, account_history y delete_post (pide confirmación).
• Mensajes y comentarios: list_conversations, send_dm, list_comments y reply_comment.
• Automatización: list_automations, create_automation y delete_automation (confirma).
• Métricas: account_insights, post_insights, analytics_summary y followers_history.

El mensaje privado a demanda (private-reply) figura solo en la API REST. Con permiso de solo lectura, el agente no publica ni envía nada. Guía completa: servidor MCP.

Reglas y límites

• Un DM solo se puede responder dentro de las 24 horas siguientes al último mensaje de la persona. Pasado ese plazo la API responde 422. Para contestar después hace falta el permiso Human Agent de Meta, que según la página de bandeja Meta todavía no concede a Zoosial.
• Ocultar comentarios (/comments/hide) no funciona en Instagram, solo en Facebook.
• Meta permite un mensaje privado por comentario, y solo a quien comentó. En dmMessage, el marcador {nombre} se quita en Instagram porque Meta no manda el nombre.
• Audiencia por edad, género o ciudad (follower_demographics): Meta pide 100 o más seguidores.
• Cada perfil admite una cuenta de Instagram.

Precio

Publicar, bandeja, comentario a mensaje, API, webhooks y MCP vienen incluidos en el plan gratis: 1 perfil con hasta 3 cuentas, sin tarjeta y sin vencimiento. El plan por perfil cuesta $95 MXN al mes + IVA por perfil, y el primer perfil no se cobra. Más tramos en precios.

Compáralo

Si comparas Zoosial con otras APIs para conectar redes sociales, mira la sección de comparativas y el artículo API para conectar redes sociales. Contrato completo: /llms.txt.

Preguntas frecuentes

← Todas las integraciones