EntrarComeçar teste grátis
easyCoexistence APIs oficiais

Publicar Stories do Instagram pela API

A API do Instagram publica um Story a partir de uma imagem ou um vídeo em uma URL pública: crie um contêiner com media_type STORIES e depois publique o contêiner. As imagens são JPEG de até 8 MB, os vídeos têm de 3 a 60 segundos e até 100 MB, a Meta recomenda um quadro 9:16, e o Story desaparece após 24 horas, como no app.

O easyCoexistence publica Stories de imagem e vídeo com publish_instagram_post a partir do Claude, do ChatGPT ou do seu próprio código, e pode agendá-los na sua própria fila.

60 s

Maior vídeo de Story que a API publica; o menor tem 3 segundos, e o arquivo pode chegar a 100 MB.

8 MB

Maior imagem de Story, que precisa ser JPEG.

24 hours

Por quanto tempo um Story publicado fica no ar antes de expirar.

Under 5

Valores de métrica de Story tão baixos voltam como código de erro 10, audiência insuficiente, em vez de um número.

Como um Story é publicado?

Com as mesmas duas chamadas de qualquer publicação. POST /<IG_ID>/media com media_type definido como STORIES e image_url ou video_url, depois POST /<IG_ID>/media_publish com o ID do contêiner. Um Story em vídeo é processado primeiro, então o status_code do contêiner precisa estar em FINISHED antes de poder ser publicado.

A referência da Meta descreve a legenda para fotos, vídeos e carrosséis, não para Stories, então o texto destinado ao espectador deve ficar na própria imagem ou vídeo.

Quais são os requisitos de mídia do Story?

A Meta recomenda um quadro 9:16 para imagens e vídeos de Story, para evitar cortes ou espaço em branco.

  • Imagem: JPEG, até 8 MB, em sRGB; outros espaços de cor são convertidos.
  • Vídeo: MOV ou MP4 com vídeo H.264 ou HEVC e áudio AAC, de 23 a 60 quadros por segundo, até 1920 pixels de largura e 25 Mbps.
  • Duração do vídeo: de 3 a 60 segundos, com arquivo de até 100 MB.
  • Proporção do vídeo: qualquer valor de 0.1:1 a 10:1 é aceito.

O que um Story pode levar?

A própria imagem ou vídeo, e menções a outras contas: desde julho de 2025, o parâmetro user_tags marca contas públicas em Stories de imagem e vídeo, com as coordenadas x e y opcionais. A Meta não oferece suporte à publicação de adesivos pela API, então links, enquetes e localizações ficam no app.

O que acontece depois que um Story é publicado?

Ele permanece no ar por 24 horas e depois expira, como no app. A Meta lista os Stories ao vivo em uma edge de stories separada; a lista de mídias da conta, GET /<IG_ID>/media, não os inclui. Ao ser lido de volta, o media_type de um Story é IMAGE ou VIDEO, igual ao de qualquer outra mídia, então diferencie os Stories pelo lugar onde os encontrou, não pelo tipo.

Como chegam as respostas e menções?

Como mensagens diretas. Uma resposta a um Story chega à conta como DM no webhook de mensagens, com o ID e a URL do Story anexados, e abre a janela habitual de 24 horas para responder. Quando alguém menciona a conta no próprio Story, isso também chega como mensagem, com um anexo do tipo story_mention. A API de Menções da Meta não cobre Stories.

Quais métricas um Story informa?

Alcance, visualizações, compartilhamentos, respostas, seguidores, visitas ao perfil, atividade do perfil, navegação, cliques em links, republicações e interações totais, lidos pelo endpoint de insights de mídia. Eles ficam disponíveis apenas por 24 horas, e um valor abaixo de 5 retorna o código de erro 10, audiência insuficiente, em vez de um número. Respostas de pessoas na Europa e no Japão ficam fora da contagem, e um Story criado por uma conta de lá informa 0 respostas.

Erros comuns

  • Planejar um adesivo de link. A API não publica adesivos, então um link precisa chegar às pessoas de outra forma, como por uma resposta em DM.
  • Ler as métricas de Story no dia seguinte. Elas ficam disponíveis apenas por 24 horas, então colete-as enquanto o Story estiver no ar.
  • Procurar um Story publicado na lista de mídias da conta. Stories ao vivo aparecem em uma edge de stories separada.
  • Publicar um vídeo horizontal como Story. A Meta recomenda 9:16, e outros formatos podem mostrar espaço em branco ou sofrer cortes.
Fazendo isso com o EasyCoexistence

Respostas a um Story chegam como DMs, que podem ser encaminhadas ao seu endpoint ou receber resposta de uma automação. De US$ 9 a US$ 0.75 por número conectado por mês, caindo conforme você adiciona números, com os primeiros 3 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

Posso adicionar um adesivo de link a um Story pela API?

Não. A Meta não oferece suporte à publicação de adesivos pela API, incluindo links, enquetes e localizações. Mencionar outra conta sem adesivo é suportado.

Onde um Story publicado aparece na API?

Na edge de stories separada da conta enquanto ele está no ar. GET /<IG_ID>/media não inclui Stories, e um Story é lido de volta como IMAGE ou VIDEO.

Um Story pode ter legenda pela API?

Não. A referência da Meta não descreve legenda para Stories, e o publish_instagram_post envia um Story sem legenda, então o texto destinado ao espectador vai na própria imagem ou vídeo.

Por quanto tempo os insights de Story ficam disponíveis?

Por 24 horas. A Meta disponibiliza as métricas de Story apenas por esse período, então leia-as enquanto o Story estiver no ar.

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