Publica en Instagram desde tu propio backend, con una sola API REST.
Imágenes, carruseles mixtos y vídeos que se publican como Reels, en cuentas profesionales conectadas. Creas un trabajo de publicación y consultas su estado hasta published.
POST /publishing/jobs -> pending
GET /publishing/jobs/{id} -> processing
GET /publishing/jobs/{id} -> submitted
GET /publishing/jobs/{id} -> published
// requestedPublishAt programa el trabajo.
// clientRequestId hace seguro un reintento. Imágenes, carruseles y Reels.
Una imagen, un carrusel que mezcla imágenes y vídeo, o un vídeo que se publica como Reel.
Cuentas profesionales.
Cuentas de Instagram Business y Creator, conectadas mediante el flujo OAuth de la plataforma.
Crea un trabajo y consúltalo.
La publicación es asíncrona. El trabajo pasa por estados desde pending hasta published.
100 posts por cuenta.
Cada cuenta conectada publica 100 posts por periodo de facturación, y un endpoint de límites muestra el uso en vivo.
// endpoints
- POST /publishing/jobs
- GET /publishing/jobs
- GET /publishing/jobs/{id}
- POST /publishing/jobs/{id}/cancel
- POST /publishing/jobs/{id}/retry
// reglas de Instagram, validadas antes de enviar nada
- ● Solo cuentas profesionales: Business o Creator.
- ● Imágenes, carruseles mixtos y vídeos. Un vídeo se publica como Reel.
- ● Los medios se pasan como URLs públicas en el trabajo. No hay endpoint de subida.
- ● 100 posts por cuenta conectada y periodo de facturación.
- ● Las estadísticas necesitan sus scopes. Una conexión solo de publicación los añade con una reconexión.
Lo que los desarrolladores preguntan primero.
¿Qué puedo publicar en una cuenta de Instagram?
Imágenes, carruseles que mezclan imágenes y vídeo, y vídeos. Un vídeo se publica como Reel. Los medios se pasan como URLs públicas en el trabajo, así que tú alojas el archivo y nosotros lo descargamos.
¿Necesito una cuenta de Instagram Business?
Necesitas una cuenta profesional, es decir Business o Creator. Las cuentas personales no pueden publicar por la API de la plataforma. La cuenta se conecta una vez mediante OAuth y pertenece a tu organización.
¿Cómo sé que el post ya está publicado?
Consulta el trabajo hasta que llegue a published. Un trabajo puede apuntar a varias cuentas conectadas, y cada destino tiene su propio resultado de entrega. Cada fallo lleva una categoría, un código y qué hacer a continuación.
¿Cuántos posts puede publicar cada cuenta?
Cada cuenta conectada publica 100 posts por periodo de facturación. El endpoint de límites muestra el límite configurado, el uso actual y el margen restante, para que tu código lo compruebe antes de publicar.
¿También puedo leer las estadísticas de Instagram?
Sí, en cuentas profesionales. Las estadísticas viven en el dashboard y como herramienta MCP, no como scope de clave. Una conexión creada solo para publicar se actualiza con una reconexión de un clic.