Iniciar sessãoIniciar teste gratuito
easyCoexistence APIs oficiais

Incorporar publicações do Instagram num site com oEmbed

O endpoint oEmbed do Instagram da Meta, GET /instagram_oembed?url=<POST_URL>, devolve o HTML que incorpora uma publicação ou Reel pública do Instagram numa página web, com a versão, provider_name, provider_url, type e width. Desde 15 de maio de 2026 pode ser chamado sem token de acesso, e o HTML carrega o embed.js do Instagram para desenhar a publicação.

O easyCoexistence devolve, através de list_social_posts, o permalink de cada publicação das contas Instagram ligadas, pronto a passar ao oEmbed, e permite ao Claude, ao ChatGPT ou ao seu próprio código publicar, agendar e responder a comentários e mensagens diretas na conta, através da API oficial da Meta.

15 May 2026

Desde esta data, a API oEmbed do Instagram da Meta pode ser chamada sem token de acesso, em todas as versões.

1,000/hour

Pedidos por hora que o guia oEmbed da Meta permite.

320 to 658

O intervalo que maxwidth aceita; maxheight não é suportado.

3 Nov 2025

Data em que author_name, author_url e os campos de miniatura saíram das respostas oEmbed do Instagram, em todas as versões da API.

Stories

Não suportado pelo endpoint oEmbed, nem as publicações de contas privadas, inativas ou com restrição de idade.

Como funciona o endpoint oEmbed do Instagram?

Envia-se o URL de uma publicação pública e recebe-se o HTML que a apresenta. O endpoint funciona no host principal da Graph API da Meta, o mesmo que as chamadas do Facebook Login, e não em graph.instagram.com. A resposta é um pequeno objeto JSON cujo campo html é colocado na página tal como está.

A request and its response
GET /instagram_oembed?url=https://www.instagram.com/p/<SHORTCODE>/

{
  "version": "1.0",
  "provider_name": "Instagram",
  "provider_url": "https://www.instagram.com/",
  "type": "rich",
  "width": 658,
  "html": "<EMBED_HTML>"
}

Que URLs aceita?

Três formatos, tal como o guia da Meta os lista para o parâmetro url, que pode ser enviado simples ou codificado em URL; os dois exemplos do guia mostram um de cada:

  • Publicações com imagem única e carrosséis: https://www.instagram.com/p/{media-shortcode}/
  • Vídeos e Reels: https://www.instagram.com/reel/{media-shortcode}/
  • Perfis: https://www.instagram.com/{username}

Precisa de token de acesso?

Não desde 15 de maio de 2026, data em que o changelog da Meta indica que a API oEmbed do Instagram passou a poder ser chamada sem token. Antes disso, as aplicações precisavam da funcionalidade Meta oEmbed Read através da App Review e de um token em cada chamada, e o acesso com token continua a funcionar. O guia oEmbed da Meta permite até 1.000 pedidos por hora, e o anúncio da Meta sobre o acesso sem token diz que as aplicações com token podem ter limites de pedidos mais elevados.

Que parâmetros aceita?

Quatro além de url, do guia da Meta e da sua referência:

  • maxwidth: de 320 a 658; a incorporação é, de resto, responsiva, e maxheight não é suportado.
  • hidecaption: true oculta a legenda da publicação; por predefinição é false.
  • omitscript: true deixa o script fora do HTML, para páginas que carregam o embed.js uma vez por si próprias e chamam instgrm.Embeds.process().
  • fields: limita a resposta aos campos indicados.

O que contém a resposta?

Seis campos por predefinição: html, a marcação a apresentar; version, sempre 1.0; provider_name e provider_url, que identificam o Instagram; type, o tipo de recurso oEmbed; e width, em pixels. A Meta retirou author_name, author_url, thumbnail_url, thumbnail_width e thumbnail_height das respostas de publicações do Instagram, em todas as versões da API, a 3 de novembro de 2025. Nas publicações da sua própria conta, o edge media continua a devolver username, permalink e thumbnail_url.

O que não pode ser incorporado?

O guia da Meta indica o que o endpoint deixa de fora, e uma regra de utilização:

  • Publicações de contas privadas, inativas e com restrição de idade.
  • Contas que desativaram as incorporações.
  • Stories, e páginas que apresentam a incorporação dentro de um Shadow DOM.
  • Qualquer utilização para além de uma visualização no front-end: a Meta proíbe expressamente usar os metadados ou o conteúdo do endpoint para outros fins.

Como incorporar as publicações da sua própria conta?

Obtenha o permalink de cada publicação e passe-o como url. Através do easyCoexistence, list_social_posts devolve as publicações recentes da conta ligada, com os respetivos permalinks, a partir do Claude, do ChatGPT ou do seu próprio código. Como a chamada oEmbed não precisa de token, o seu site pode fazê-la diretamente.

Erros comuns

  • Enviar um link de Story. O endpoint oEmbed da Meta não suporta Stories; incorpore uma publicação ou um Reel.
  • Ler thumbnail_url da resposta. A Meta retirou-o, juntamente com author_name e os outros campos de miniatura, a 3 de novembro de 2025.
  • Definir maxwidth abaixo de 320 ou acima de 658. A Meta aceita valores apenas nesse intervalo, e maxheight não é aceite de todo.
  • Carregar o embed.js em cada incorporação. Com omitscript definido como true, carregue o script uma única vez e chame instgrm.Embeds.process().
Fazer isto com a EasyCoexistence

Entre US$ 9 e US$ 0.75 por ligação por mês, a descer à medida que adiciona ligações, com os primeiros 3 dias gratuitos.

Perguntas frequentes

Posso incorporar um Instagram Reel?

Sim. Passe o seu URL https://www.instagram.com/reel/{media-shortcode}/ e o endpoint devolve o HTML de incorporação.

A incorporação do Instagram é responsiva?

Sim. O guia da Meta indica que a incorporação é responsiva, e maxwidth define a largura máxima que pode atingir.

Posso incorporar um perfil do Instagram?

Sim. O guia da Meta lista os URLs de perfil, https://www.instagram.com/{username}, entre os formatos que o parâmetro url aceita.

Posso usar os dados do oEmbed para análises?

Não. A Meta só permite o endpoint para mostrar a publicação numa página ou numa aplicação, e proíbe outras utilizações dos seus metadados e conteúdo.

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