Instagram

API de publicação no Instagram. Publique imagens, carrosséis e Reels a partir do seu próprio backend.

Imagens, carrosséis mistos e vídeos publicados como Reels, em contas profissionais conectadas. Você cria um trabalho de publicação e consulta o status até published.

Obter chave de API → Ler a documentação

POST /publishing/jobs          -> pending

GET  /publishing/jobs/{id}     -> processing
GET  /publishing/jobs/{id}     -> submitted
GET  /publishing/jobs/{id}     -> published

// requestedPublishAt agenda o trabalho.
// clientRequestId torna uma nova tentativa segura.

Imagens, carrosséis e Reels.

Uma imagem, um carrossel que mistura imagens e vídeo, ou um vídeo publicado como Reel.

Contas profissionais.

Contas Instagram Business e Creator, conectadas pelo fluxo OAuth da plataforma.

Crie um trabalho e consulte o status.

A publicação é assíncrona. O trabalho passa por estados de pending até published.

100 posts por conta.

Cada conta conectada publica 100 posts por período de cobrança, e um endpoint de limites mostra o uso em tempo real.

// endpoints

POST /publishing/jobs
GET /publishing/jobs
GET /publishing/jobs/{id}
POST /publishing/jobs/{id}/cancel
POST /publishing/jobs/{id}/retry

// regras do Instagram, validadas antes de enviar algo

● Apenas contas profissionais: Business ou Creator.
● Imagens, carrosséis mistos e vídeos. Um vídeo é publicado como Reel.
● A mídia é passada como URLs públicas no trabalho. Não há endpoint de upload.
● 100 posts por conta conectada por período de cobrança.
● As estatísticas precisam dos respectivos scopes. Uma conexão só de publicação os adiciona com uma reconexão.

// por onde continuar

FAQ do Instagram

O que os desenvolvedores perguntam primeiro.

O que posso publicar em uma conta do Instagram?

Imagens, carrosséis que misturam imagens e vídeo, e vídeos. Um vídeo é publicado como Reel. A mídia é passada como URLs públicas no trabalho, então você hospeda o arquivo e nós o buscamos.

Preciso de uma conta Instagram Business?

Você precisa de uma conta profissional, ou seja, Business ou Creator. As contas pessoais não podem publicar pela API da plataforma. A conta é conectada uma vez por OAuth e pertence à sua organização.

Como sei que o post já está publicado?

Consulte o trabalho até ele chegar a published. Um trabalho pode apontar para várias contas conectadas, e cada destino tem seu próprio resultado de entrega. Cada falha traz uma categoria, um código e o que fazer em seguida.

Quantos posts cada conta pode publicar?

Cada conta conectada publica 100 posts por período de cobrança. O endpoint de limites mostra o limite configurado, o uso atual e a cota restante, para que seu código verifique antes de publicar.

Também posso ler as estatísticas do Instagram?

Sim, em contas profissionais. As estatísticas vivem no dashboard e como ferramenta MCP, não como scope de chave. Uma conexão criada só para publicar é atualizada com uma reconexão de um clique.

Como publico no Instagram pela API?

Conecte a conta profissional do Instagram uma vez no dashboard e envie um trabalho de publicação com a conta de destino, a legenda e as URLs públicas do conteúdo. O trabalho responde na hora. Consulte o trabalho até ele chegar a publicado, ou leia a categoria da falha se não chegar.

Posso agendar publicações do Instagram pela API?

Sim. Defina requestedPublishAt ao criar o trabalho e ele é publicado nesse horário. Um trabalho agendado pode ser cancelado antes de ser enviado, e é aí que cabe um passo de revisão.

Posso automatizar publicações do Instagram com a API?

Sim, pela API oficial do Instagram, sem fazer login como o usuário. Seu código ou seu agente cria os trabalhos, e o clientRequestId torna seguro repetir uma requisição, então um timeout nunca se transforma em uma publicação duplicada.

Posso publicar Stories do Instagram?