Iniciar sessãoIniciar teste gratuito
easyCoexistence APIs oficiais

Publicar Reels do Instagram através da API

A API do Instagram publica um Reel a partir de um ficheiro MOV ou MP4 alojado num URL público: cria um container com media_type REELS, aguarda enquanto a Meta processa o vídeo e, em seguida, publica-o. Um Reel tem entre 3 segundos e 15 minutos e até 300 MB, e a Meta recomenda um enquadramento 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: indique-lhe o URL do vídeo e a legenda, e, enquanto o vídeo ainda está a ser processado, conclui a publicação por si.

15 min

O Reel mais longo que a API publica; o mais curto tem 3 segundos.

300 MB

Maior ficheiro de Reel, em MOV ou MP4 com vídeo H.264 ou HEVC e áudio AAC.

1 min

Frequência com que a Meta sugere verificar o estado de um container em processamento, durante no máximo 5 minutos.

24 hours

Tempo máximo que um container de Reel pode aguardar sem ser publicado antes de expirar.

Como se publica um Reel?

Em três passos. Primeiro, envie POST /<IG_ID>/media com media_type definido como REELS, video_url a apontar para o ficheiro e, se quiser, uma legenda; a Meta obtém 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, envie POST /<IG_ID>/media_publish com creation_id definido como o ID do container, e a resposta devolve o ID do novo media.

A Meta documenta o seu carregamento retomável, que permite enviar um ficheiro a partir de um computador, apenas para configurações baseadas no Facebook Login for Business, incluindo o Unified Login. Com o Instagram Login, o vídeo provém sempre de um URL público.

Quais são os requisitos de vídeo?

A especificação da Meta para Reels, que um ficheiro tem de cumprir antes de o Instagram o processar:

  • Container: MOV ou MP4 (MPEG-4 Parte 14), sem listas de edição, com o átomo moov no início do ficheiro.
  • Vídeo: H.264 ou HEVC, varrimento progressivo, GOP fechado, subamostragem de crominância 4:2:0, 23 a 60 fotogramas por segundo, até 1920 píxeis de largura e 25 Mbps.
  • Áudio: AAC, até 48 kHz, mono ou estéreo, a 128 kbps.
  • Proporção: qualquer valor entre 0,01:1 e 10:1, com 9:16 recomendado.
  • Duração e tamanho: de 3 segundos a 15 minutos, até 300 MB.

O que acontece enquanto o vídeo está a ser processado?

O status_code do container lê IN_PROGRESS enquanto o Instagram processa o vídeo, passando depois a FINISHED, e só então pode ser publicado. Publicar antes disso falha com o código 9007, subcódigo 2207027, o que significa que é preciso aguardar e não corrigir. A Meta sugere verificar o estado uma vez por minuto, durante no máximo 5 minutos.

ERROR significa que o container não concluiu o processamento, e EXPIRED significa que esteve por publicar durante 24 horas; em ambos os casos é preciso um novo container. PUBLISHED significa que o Reel já está publicado.

Que opções de Reel oferece a API?

Para além do vídeo e da legenda, o container de Reel da Meta aceita estes parâmetros:

  • share_to_feed: true faz com que o Reel apareça no Feed além do separador Reels; false mantém-no apenas no separador Reels. Nenhum dos valores garante lugar no separador Reels.
  • cover_url: uma imagem JPEG até 8 MB usada como capa no separador Reels, recortada ao centro em 9:16 e, quando partilhada no Feed, num quadrado.
  • thumb_offset: o fotograma, em milissegundos, usado como miniatura quando não há capa; 0 é o primeiro fotograma.
  • audio_name: um nome para o áudio do Reel, que só pode ser definido uma vez.
  • trial_params: publica um Reel de teste, partilhado apenas com pessoas que não seguem a conta, até ser promovido a Reel normal.

O que mais se aplica a um Reel?

Algumas regras acompanham um Reel desde o momento em que o seu container é criado.

  • Um Reel não pode ser um item de carrossel; é sempre publicado sozinho.
  • As definições de privacidade da conta aplicam-se na publicação: com Permitir remix ativado, o novo Reel também permite remix.
  • A marcação de música está disponível apenas para áudio original.
  • Quando é consultado mais tarde, um Reel indica media_type VIDEO, como qualquer outro vídeo.
  • Conta como uma das 100 publicações que a conta pode fazer através da API em 24 horas.

Que métricas indica um Reel?

Através do endpoint de insights de media, um Reel indica 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 percentagem de visualizações que saltaram nos primeiros 3 segundos. Likes, comments e views contam apenas atividade orgânica, e os dados que lhes estão associados podem atrasar até 48 horas.

Erros comuns

  • Publicar no momento em que o container é criado. Aguarde até que status_code indique FINISHED, ou a chamada falha com o subcódigo 2207027.
  • Enviar um ficheiro WebM ou AVI. Os Reels têm de ser MOV ou MP4, ou a Meta recusa-os com o código 352, subcódigo 2207026.
  • Esperar que share_to_feed coloque o Reel no separador Reels. Apenas acrescenta o Feed; é o Instagram que decide o que o separador Reels mostra.
  • Deixar um container sem publicar durante a noite. Expira 24 horas após a criação, e a publicação exige então um novo.
Fazer isto com a EasyCoexistence

Os Reels também podem ser agendados a partir da sua própria fila. De US$ 9 a US$ 0,75 por ligação por mês, a descer à medida que acrescenta ligações, com os primeiros 3 dias grátis.

Perguntas frequentes

Quanto tempo pode durar um Reel através da API?

De 3 segundos a 15 minutos, em ficheiro MOV ou MP4 até 300 MB.

Posso enviar um Reel a partir do meu computador?

Não com o Instagram Login. A API obtém o vídeo a partir de um URL público, por isso coloque primeiro o ficheiro num local que lhe dê uma ligação pública.

Um Reel publicado através da API também aparece no Feed?

Pode aparecer. O parâmetro share_to_feed decide se o Reel pode aparecer no Feed além do separador Reels.

Porque falha a publicação de um Reel com 9007?

O Instagram ainda está a processar o vídeo. Verifique o status_code do container e publique quando indicar FINISHED; nada no pedido precisa de ser corrigido.

Continue a ler

Ligue o seu primeiro canal em dois minutos.

Sem revisões de plataformas para esperar. Ligue o WhatsApp, o Instagram, o TikTok ou outro canal, peça depois à sua IA que publique, responda ou faça um relatório, e veja-a trabalhar.

  • 3 dias grátis
  • Cancele quando quiser
  • Só APIs oficiais
  • Monitorizado 24/7

Verificado em