Instagram BulkPublish

API do Instagram

Publique, agende e gerencie o Instagram a partir do seu próprio código. Uma API REST e uma chave cobrem o Instagram e todas as outras redes que você conectar, então você escreve a integração uma vez só.

Obter uma chave de API grátis Ler a referência da API

Integração do Instagram com o BulkPublish

O que a API do Instagram cobre

Tudo abaixo faz parte da API publicada e já funciona com o Instagram.

Recurso	Endpoint
Criar, agendar, editar e publicar posts	`POST /api/posts`
Enviar imagens e vídeos	`POST /api/media`
Encontrar o próximo horário livre da sua fila	`GET /api/posts/queue-slot`
Criar agendamentos recorrentes	`POST /api/schedules`
Publicar novos itens de um feed RSS	`POST /api/rss-feeds`
Publicar um primeiro comentário automaticamente	`platformSpecific._firstComment`
Publicar um post como Story	`POST /api/posts/{id}/story`
Ler as métricas de cada post	`GET /api/posts/{id}/metrics`
Ler e responder comentários de posts publicados	`GET /api/posts/{id}/engagement, POST /api/posts/{id}/comments/reply`
Ler e responder mensagens diretas	`GET /api/inbox/conversations, POST /api/inbox/conversations/{id}/messages`
Verificar se a conexão está saudável	`GET /api/channels/{id}/health`
Consultar o uso do seu plano	`GET /api/quotas/usage`

Tipos de post que você pode publicar no Instagram

Escolha o tipo com postTypeOverrides. Um tipo que o Instagram não oferece é recusado antes de qualquer coisa entrar na fila.

Tipo de publicação	Mídia
`feed_photo` Feed Photo	Obrigatório: 1 imagem
`feed_video` Feed Video	Obrigatório: 1 vídeo
`reel` Reel	Obrigatório: 1 vídeo
`story` Story	Obrigatório: 1 imagem ou vídeo
`carousel` Carousel	Obrigatório: de 2 a 10 imagens ou vídeos

Agende um post do Instagram com curl

Três requisições: encontre seu canal, envie o arquivo se o post tiver um e crie o post. Troque a chave por uma de Configurações, depois Chaves de API, e o 12 pelo id do seu próprio canal.

1. Liste seus canais e anote o id da sua conta do Instagram.

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

2. Envie o arquivo. A resposta traz o id da mídia, usado como mediaFiles abaixo.

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

3. Crie o post.

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
    }
  }
}'

A resposta é o post criado, com seu id e status. Busque-o depois com GET /api/posts/{id} para ver como foi.

Opções do Instagram

Envie estas opções dentro de platformSpecific, na chave do Instagram.

Opção	O que faz	Aceita
`collaborators`	Nomes de usuário para marcar como coautores	texto
`shareToStory`	Compartilhar também em um Story	verdadeiro ou falso
`trialReel`	Publicar como Reel de teste	verdadeiro ou falso
`graduationStrategy`	Como um Reel de teste vira um Reel normal	`manualauto`
`thumbnailTimestamp`	Quadro da capa, em segundos desde o início	um número
`coverUrl`	Imagem de capa, a partir de uma URL pública	texto

Análises do Instagram pela API

Estas métricas voltam para cada post do Instagram em GET /api/posts/{id}/metrics, com registros ao longo do tempo.

Impressões
Alcance
Curtidas
Comentários
Compartilhamentos
Salvamentos
Taxa de engajamento

Comentários e mensagens

Pela API você pode ler e responder comentários de posts publicados e ler e responder mensagens diretas.

No Instagram, as respostas são aceitas até 24 horas depois da última mensagem da pessoa.

Ler comentários funciona em todos os planos. Responder comentários exige um plano pago, e a caixa de entrada faz parte do Pro e do Business. Enquanto um recurso não estiver ativado na sua conta, a API responde 403 com um código que você pode verificar.

Acesso à API em todos os planos

Todos os planos incluem chaves de API, inclusive o Free. Veja o que cada um permite.

Plano	Chaves de API	Requisições por dia
Free	1	30
Pro	5	5.000
Business	10	50.000

Construir direto no Instagram ou usar o BulkPublish

Ir direto é uma escolha válida, principalmente se você precisa de algo que o BulkPublish não oferece. Isto é o que Instagram Platform API exige de você, conferido com a documentação em outubro de 2026.

Publicar exige uma conta profissional.
Limite documentado: 100 posts publicados pela API em 24 horas.
A mídia é buscada em uma URL pública que você precisa hospedar.
Um post com mídia exige várias chamadas: enviar ou criar, esperar o processamento e depois publicar.
Os tokens de acesso duram cerca de 60 dias, então você precisa de um jeito próprio de renová-los ou reconectar antes que expirem.

O BulkPublish cuida da conexão por você: renova os tokens, confere cada post com as regras do Instagram antes de entrar na fila e informa no post qual destino falhou, então seu código faz uma única requisição.

Ler a documentação oficial

Prefere pedir a um assistente?

Claude, ChatGPT e Cursor fazem o mesmo pelo servidor MCP do Instagram, com comandos em vez de código.

Ver o servidor MCP do Instagram

Prefere um calendário a código?

A mesma conta do Instagram pode ser agendada pelo app, com calendário de conteúdo e envio em massa.

Ver o agendador do Instagram

Perguntas frequentes

Dúvidas comuns sobre a API do Instagram.

Existe uma API do Instagram que eu possa usar sem construir a integração sozinho?

Sim. O BulkPublish oferece o Instagram por meio da sua API REST. Conecte sua conta do Instagram uma vez e depois publique, agende e gerencie com uma chave. A mesma chave funciona em todas as outras redes que você conectar.

O que posso publicar no Instagram pela API?

Os tipos de post são Feed Photo, Feed Video, Reel, Story e Carousel. Cada um é conferido com as regras de mídia do Instagram antes de entrar na fila, então uma requisição que o Instagram recusaria falha na hora, com um erro claro.

Posso agendar posts do Instagram pela API?

Sim. Envie o status "scheduled" com um horário em scheduledAt e um timezone, ou peça antes o próximo horário livre da sua fila. Agendamentos recorrentes e feeds RSS também estão disponíveis.

Posso ler as análises do Instagram pela API?

Sim. As métricas por post incluem Impressões, Alcance, Curtidas, Comentários, Compartilhamentos, Salvamentos e Taxa de engajamento, com registros ao longo do tempo.

Posso ler e responder comentários ou mensagens do Instagram pela API?

Sim. Você pode ler e responder comentários de posts publicados e ler e responder mensagens diretas. Responder comentários exige um plano pago, e a caixa de entrada faz parte do Pro e do Business.

A API do Instagram custa algo a mais?

Não. O acesso à API está em todos os planos. O Free inclui 1 chave e 30 requisições por dia, o Pro 5 chaves e 5.000 por dia, o Business 10 chaves e 50.000 por dia.

Preciso de uma conta de desenvolvedor do Instagram ou de uma revisão de app?

Não para usar o BulkPublish. Você conecta sua conta do Instagram na página Canais e publica com uma chave do BulkPublish. Se preferir construir direto na API do Instagram, a seção acima lista o que ela exige de você.

Um assistente de IA também consegue fazer isso?

Sim. A página do servidor MCP do Instagram mostra como conectar Claude, ChatGPT ou Cursor e o que pedir.

A mesma chave e o mesmo formato de requisição funcionam em 15 redes.