Como publicar Reels do Instagram pela API
A API do Instagram publica um Reel a partir de um arquivo MOV ou MP4 hospedado em uma URL pública: crie um container com media_type REELS, aguarde enquanto a Meta processa o vídeo e depois publique. Um Reel pode ter de 3 segundos a 15 minutos e até 300 MB, e a Meta recomenda o formato 9:16 para evitar cortes ou espaços em branco.
O easyCoexistence publica Reels com publish_instagram_post a partir do Claude, do ChatGPT ou do seu próprio código: informe a URL do vídeo e a legenda e, enquanto o vídeo ainda estiver sendo processado, ele conclui a publicação por conta própria.
Duração máxima de um Reel publicado pela API; a mínima é de 3 segundos.
Tamanho máximo do arquivo de um Reel, em MOV ou MP4 com vídeo H.264 ou HEVC e áudio AAC.
Com que frequência a Meta sugere verificar o status de um container em processamento, por no máximo 5 minutos.
Quanto tempo um container de Reel pode ficar sem ser publicado antes de expirar.
Como um Reel é publicado?
Em três etapas. Primeiro, faça POST /<IG_ID>/media com media_type definido como REELS, video_url apontando para o arquivo e, se quiser, uma legenda; a Meta busca o vídeo e devolve um ID de container. Segundo, aguarde enquanto o Instagram processa o vídeo, verificando o status_code do container. Terceiro, faça POST /<IG_ID>/media_publish com creation_id definido como o ID do container; a resposta traz o ID da nova mídia.
A Meta só documenta o upload retomável, que permite enviar um arquivo do computador, para configurações baseadas no Facebook Login for Business, incluindo o Unified Login. Com o Instagram Login, o vídeo sempre vem de uma URL pública.
Quais são os requisitos do vídeo?
Esta é a especificação da Meta para Reels, que o arquivo precisa atender para que o Instagram o processe:
- Container: MOV ou MP4 (MPEG-4 Parte 14), sem edit lists, com o moov atom no início do arquivo.
- Vídeo: H.264 ou HEVC, varredura progressiva, GOP fechado, subamostragem de croma 4:2:0, de 23 a 60 quadros por segundo, até 1920 pixels de largura e 25 Mbps.
- Áudio: AAC, até 48 kHz, mono ou estéreo, a 128 kbps.
- Proporção: qualquer valor de 0,01:1 a 10:1, sendo 9:16 o recomendado.
- Duração e tamanho: de 3 segundos a 15 minutos, até 300 MB.
O que acontece enquanto o vídeo é processado?
O status_code do container fica como IN_PROGRESS até o Instagram terminar de processar o vídeo e depois passa para FINISHED; só então ele pode ser publicado. Publicar antes disso falha com o código 9007, subcode 2207027, o que significa que basta esperar, não há nada a corrigir. A Meta sugere verificar o status uma vez por minuto, por no máximo 5 minutos.
ERROR significa que o container não conseguiu concluir o processamento, e EXPIRED significa que ele ficou 24 horas sem ser publicado; nos dois casos é preciso criar um novo container. PUBLISHED significa que o Reel já está no ar.
Quais opções de Reel a API oferece?
Além do vídeo e da legenda, o container de Reel da Meta aceita estes parâmetros:
share_to_feed: true permite que o Reel apareça no Feed além da aba Reels; false o mantém só na aba Reels. Nenhum dos dois valores garante espaço na aba Reels.cover_url: um JPEG de até 8 MB usado como capa na aba Reels, recortado na área central em 9:16, e em quadrado quando o Reel é compartilhado no Feed.thumb_offset: o quadro, em milissegundos, usado como miniatura quando não há capa; 0 é o primeiro quadro.audio_name: um nome para o áudio do Reel, que só pode ser definido uma vez.trial_params: publica um Reel de teste, que só é mostrado a quem não segue a conta até ser promovido.
Que outras regras valem para um Reel?
Algumas regras acompanham o Reel desde o momento em que o container é criado.
- Um Reel não pode ser item de carrossel; ele é sempre publicado sozinho.
- As configurações de privacidade da conta valem na publicação: com Allow remixing ativado, o novo Reel também permite remix.
- A marcação de música só está disponível para áudio original.
- Quando consultado depois, o Reel aparece com
media_typeVIDEO, como qualquer outro vídeo. - Ele conta como uma publicação dentro do limite de 100 publicações feitas pela API por conta em 24 horas.
Quais métricas um Reel informa?
Pelo endpoint de insights de mídia, um Reel informa reach, views, likes, comments, saved, shares, total_interactions e reposts, além de três métricas próprias: ig_reels_avg_watch_time, ig_reels_video_view_total_time e reels_skip_rate, a proporção de visualizações em que o Reel foi pulado nos primeiros 3 segundos. Likes, comments e views contam apenas a atividade orgânica, e os dados por trás deles podem ter atraso de até 48 horas.
Erros comuns
- Publicar assim que o container é criado. Aguarde até o status_code mostrar FINISHED, senão a chamada falha com o subcode 2207027.
- Enviar um arquivo WebM ou AVI. Reels precisam ser MOV ou MP4, senão a Meta os recusa com o código 352, subcode 2207026.
- Achar que share_to_feed coloca o Reel na aba Reels. Ele só adiciona o Feed; quem decide o que aparece na aba Reels é o Instagram.
- Deixar um container sem publicar de um dia para o outro. Ele expira 24 horas após a criação, e aí é preciso criar outro para publicar.
Os Reels também podem ser agendados na fila de agendamento do próprio easyCoexistence. De R$ 29,90 a R$ 3,90 por conexão por mês, com o valor caindo conforme você adiciona conexões, e os 3 primeiros dias grátis.
O easyCoexistence é uma API e um servidor MCP multicanal que conecta agentes de IA, como o Claude e o ChatGPT, ao WhatsApp, Instagram, TikTok, Facebook e mais. No WhatsApp, ele usa o Coexistence: a empresa continua usando o número no app WhatsApp Business enquanto a IA trabalha pela API oficial da Meta.
Perguntas frequentes
Qual a duração permitida para um Reel publicado pela API?
De 3 segundos a 15 minutos, em arquivo MOV ou MP4 de até 300 MB.
Posso fazer upload de um Reel direto do meu computador?
Não com o Instagram Login. A API busca o vídeo em uma URL pública, então hospede o arquivo antes em um lugar que gere um link público.
Um Reel publicado pela API também aparece no Feed?
Pode aparecer. O parâmetro share_to_feed define se o Reel pode aparecer no Feed além da aba Reels.
Por que a publicação de um Reel falha com o erro 9007?
O Instagram ainda está processando o vídeo. Verifique o status_code do container e publique quando ele mostrar FINISHED; não há nada a corrigir na requisição.
Continue lendo
Conecte seu primeiro canal em dois minutos.
Sem esperar aprovação das plataformas. Conecte o WhatsApp, o Instagram, o TikTok ou outro canal, peça para a sua IA publicar, responder ou trazer os números, e veja funcionando.
- 3 dias grátis
- Cancele quando quiser
- Só APIs oficiais
- Monitorado 24/7
Verificado em