Instagram BulkPublish

API de Instagram

Publica, programa y gestiona Instagram desde tu propio código. Una API REST y una clave cubren Instagram y cualquier otra red que conectes, así que la integración se escribe una sola vez.

Consigue una clave de API gratis Lee la referencia de la API

Integración de Instagram con BulkPublish

Qué cubre la API de Instagram

Todo lo que aparece abajo forma parte de la API publicada y funciona hoy con Instagram.

Función	Endpoint
Crear, programar, actualizar y publicar publicaciones	`POST /api/posts`
Subir imágenes y vídeo	`POST /api/media`
Encontrar el siguiente hueco libre de tu cola	`GET /api/posts/queue-slot`
Crear programaciones recurrentes	`POST /api/schedules`
Publicar las novedades de un feed RSS	`POST /api/rss-feeds`
Publicar un primer comentario automáticamente	`platformSpecific._firstComment`
Publicar una publicación como Story	`POST /api/posts/{id}/story`
Leer las métricas de cada publicación	`GET /api/posts/{id}/metrics`
Leer y responder los comentarios de las publicaciones	`GET /api/posts/{id}/engagement, POST /api/posts/{id}/comments/reply`
Leer y responder mensajes directos	`GET /api/inbox/conversations, POST /api/inbox/conversations/{id}/messages`
Comprobar que la conexión funciona bien	`GET /api/channels/{id}/health`
Consultar el uso de tu plan	`GET /api/quotas/usage`

Tipos de publicación que puedes enviar a Instagram

Elige el tipo con postTypeOverrides. Un tipo que Instagram no ofrece se rechaza antes de poner nada en cola.

Tipo de publicación	Multimedia
`feed_photo` Feed Photo	Obligatorio: 1 imagen
`feed_video` Feed Video	Obligatorio: 1 vídeo
`reel` Reel	Obligatorio: 1 vídeo
`story` Story	Obligatorio: 1 imagen o vídeo
`carousel` Carousel	Obligatorio: de 2 a 10 imágenes o vídeos

Programa una publicación de Instagram con curl

Tres solicitudes: busca tu canal, sube el archivo si la publicación lo lleva y crea la publicación. Sustituye la clave por una de Ajustes, luego Claves de API, y 12 por el id de tu propio canal.

1. Lista tus canales y anota el id de tu cuenta de Instagram.

curl https://app.bulkpublish.com/api/channels \
  -H "Authorization: Bearer bp_your_key_here"

2. Sube el archivo. La respuesta te da el id del archivo, que se usa como mediaFiles más abajo.

curl -X POST https://app.bulkpublish.com/api/media \
  -H "Authorization: Bearer bp_your_key_here" \
  -F "file=@clip.mp4"

3. Crea la publicación.

curl -X POST https://app.bulkpublish.com/api/posts \
  -H "Authorization: Bearer bp_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
  "content": "Behind the scenes of launch day",
  "channels": [{ "channelId": 12 }],
  "status": "scheduled",
  "scheduledAt": "2026-12-01T09:00:00Z",
  "mediaFiles": [101],
  "postTypeOverrides": {
    "instagram": "reel"
  },
  "platformSpecific": {
    "instagram": {
      "collaborators": "bulkpublish",
      "thumbnailTimestamp": 2
    }
  }
}'

La respuesta es la publicación creada, con su id y su estado. Consúltala más tarde con GET /api/posts/{id} para ver cómo fue.

Opciones de Instagram

Envía estas opciones dentro de platformSpecific, bajo la clave de Instagram.

Opción	Qué hace	Admite
`collaborators`	Usuarios que se etiquetan como coautores	texto
`shareToStory`	Compartir también en una Story	verdadero o falso
`trialReel`	Publicar como Reel de prueba	verdadero o falso
`graduationStrategy`	Cómo un Reel de prueba pasa a ser normal	`manualauto`
`thumbnailTimestamp`	Fotograma de portada, en segundos desde el inicio	un número
`coverUrl`	Imagen de portada, desde una URL pública	texto

Analíticas de Instagram con la API

Estas métricas se devuelven para cada publicación de Instagram en GET /api/posts/{id}/metrics, con instantáneas a lo largo del tiempo.

Impresiones
Alcance
Me gusta
Comentarios
Compartidos
Guardados
Tasa de interacción

Comentarios y mensajes

Con la API puedes leer y responder los comentarios de las publicaciones y leer y responder mensajes directos.

En Instagram las respuestas se aceptan durante las 24 horas siguientes al último mensaje de la persona.

Leer comentarios funciona en todos los planes. Responder a comentarios requiere un plan de pago, y la bandeja de entrada forma parte de Pro y Business. Mientras una función no esté activada en tu cuenta, la API responde 403 con un código que puedes comprobar.

Acceso a la API en todos los planes

Todos los planes incluyen claves de API, también el plan Free. Esto es lo que permite cada uno.

Plan	Claves de API	Solicitudes al día
Free	1	30
Pro	5	5000
Business	10	50.000

Integra Instagram directamente o usa BulkPublish

Ir directo es una opción razonable, sobre todo si necesitas algo que BulkPublish no ofrece. Esto es lo que te pide Instagram Platform API, según su documentación consultada en octubre de 2026.

Para publicar hace falta una cuenta profesional.
Límite documentado: 100 publicaciones por API en 24 horas.
Los archivos se descargan desde una URL pública que tienes que alojar tú.
Una publicación con archivos requiere varias llamadas: subir o crear, esperar al procesamiento y publicar.
Los tokens de acceso duran unos 60 días, así que necesitas tu propia forma de renovarlos o reconectar antes de que caduquen.

BulkPublish mantiene la conexión por ti: renueva los tokens, comprueba cada publicación con las reglas de Instagram antes de ponerla en cola e informa de un destino fallido en la propia publicación, así que tu código hace una sola solicitud.

Lee la documentación oficial

¿Prefieres pedírselo a un asistente?

Claude, ChatGPT y Cursor pueden hacer lo mismo con el servidor MCP de Instagram, con instrucciones en lugar de código.

Ver el servidor MCP de Instagram

¿Prefieres un calendario a código?

La misma cuenta de Instagram se puede programar desde la app, con un calendario de contenido y subida en masa.

Ver el programador de Instagram

Preguntas frecuentes

Dudas habituales sobre la API de Instagram.

¿Hay una API de Instagram que pueda usar sin construir yo la integración?

Sí. BulkPublish ofrece Instagram a través de su API REST. Conecta tu cuenta de Instagram una vez y luego publica, programa y gestiónala con una clave. La misma clave sirve para cualquier otra red que conectes.

¿Qué puedo publicar en Instagram con la API?

Los tipos de publicación son Feed Photo, Feed Video, Reel, Story y Carousel. Cada uno se comprueba con las reglas de archivos de Instagram antes de ponerlo en cola, así que una solicitud que Instagram rechazaría falla al instante con un error claro.

¿Puedo programar publicaciones de Instagram con la API?

Sí. Envía el estado "scheduled" con una hora en scheduledAt y un timezone, o pide antes el siguiente hueco libre de tu cola. También hay programaciones recurrentes y feeds RSS.

¿Puedo leer las analíticas de Instagram con la API?

Sí. Las métricas por publicación incluyen Impresiones, Alcance, Me gusta, Comentarios, Compartidos, Guardados y Tasa de interacción, con instantáneas a lo largo del tiempo.

¿Puedo leer y responder comentarios o mensajes de Instagram con la API?

Sí. Puedes leer y responder los comentarios de las publicaciones y leer y responder mensajes directos. Responder a comentarios requiere un plan de pago, y la bandeja de entrada forma parte de Pro y Business.

¿La API de Instagram cuesta algo extra?

No. El acceso a la API está en todos los planes. Free incluye 1 clave y 30 solicitudes al día, Pro 5 claves y 5000 al día, Business 10 claves y 50.000 al día.

¿Necesito una cuenta de desarrollador de Instagram o una revisión de la app?

No para usar BulkPublish. Conectas tu cuenta de Instagram en la página Canales y publicas con una clave de BulkPublish. Si prefieres integrar directamente con la API de Instagram, la sección anterior enumera lo que te pide.

¿Un asistente de IA también puede hacerlo?

Sí. La página del servidor MCP de Instagram explica cómo conectar Claude, ChatGPT o Cursor y qué pedirles.

La misma clave y el mismo formato de solicitud sirven para 15 redes.