Como publicar Reels via API
O que muda ao publicar Reels em vez de posts normais no feed, e como fazer isso via API.
Por André LugA boa notícia sobre publicar Reels via API é que, do seu lado, quase nada muda. O envelope de requisição continua sendo o mesmo POST /api/posts usado para qualquer outro post no Instagram — perfil de destino, corpo do texto e mídia. O que muda de verdade é o que acontece no vídeo em si e no lado da plataforma, não no formato da sua chamada.
Se você ainda não publicou nenhum vídeo pela API, comece pelo passo a passo geral de como postar no Instagram via API.
Mesmo endpoint, resultado diferente na plataforma
Um Reels não é um recurso separado na sua chamada de API — é um vídeo publicado no mesmo envelope de post de sempre, que a Meta processa e distribui de forma diferente de um vídeo comum de feed: superfície de descoberta própria, posicionamento diferente no perfil e no Explorar, e comportamento de reprodução diferente para quem assiste. Nada disso exige um campo extra na sua requisição — é consequência do próprio vídeo enviado.
O que muda de verdade é o vídeo, não a chamada
Reels no Instagram são pensados para vídeo vertical, e costumam aceitar uma duração maior do que um vídeo comum de feed permite. Formato, proporção e limite de duração exatos são definidos pela própria Meta e podem mudar com o tempo — vale conferir os requisitos atualizados na landing da API para Instagram antes de padronizar seu pipeline de exportação de vídeo em cima de um número específico.
Enviar o vídeo
Para vídeos maiores ou reutilizados em múltiplos posts, vale pré-enviar o arquivo pelo endpoint de mídia antes de criar o post — isso permite validar o asset (dimensões, duração, tipo real do arquivo) antes do momento da publicação, em vez de descobrir um problema só na hora de publicar.
curl -X POST https://postgate.studio/api/posts \
-H "Authorization: Bearer $POSTGATE_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: reels-launch-01" \
-d '{
"post": { "body": "Assista o lançamento em vídeo curto." },
"profiles": ["pro_instagram123"],
"media": ["https://cdn.example.com/vertical-clip.mp4"]
}'Confirmar que publicou como esperado
Como com qualquer outro post, o resultado real está no array targets da resposta, não no status agregado: o ID retornado pela própria Meta e o link permanente do post confirmam que a publicação saiu do ar como o vídeo enviado, sem depender de checar manualmente dentro do app do Instagram.
