Instagram

API de publicación en Instagram. Publica imágenes, carruseles y Reels desde tu propio backend.

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.

Obtener clave API → Leer la documentación

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.

// por dónde seguir

FAQ de Instagram

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.

¿Cómo publico en Instagram con la API?

Conecta la cuenta profesional de Instagram una vez en el dashboard y envía un trabajo de publicación con la cuenta de destino, el texto y las URLs públicas del contenido. El trabajo responde al momento. Consúltalo hasta que llegue a publicado, o lee la categoría del fallo si no lo hace.

¿Puedo programar publicaciones de Instagram con la API?

Sí. Define requestedPublishAt al crear el trabajo y se publica a esa hora. Un trabajo programado se puede cancelar antes de enviarse, y ahí encaja un paso de revisión.

¿Puedo automatizar publicaciones de Instagram con la API?

Sí, a través de la API oficial de Instagram, sin iniciar sesión como el usuario. Tu código o tu agente crea los trabajos, y clientRequestId hace que reintentar una petición sea seguro, así un timeout nunca se convierte en una publicación doble.

¿Puedo publicar Stories de Instagram?