Incorporar posts do Instagram em um site com oEmbed
O endpoint oEmbed do Instagram, GET /instagram_oembed?url=<POST_URL>, devolve o HTML que incorpora um post ou Reel público do Instagram em uma página web, junto com version, provider_name, provider_url, type e width. Desde 15 de maio de 2026 ele pode ser chamado sem token de acesso, e o HTML carrega o embed.js do Instagram para desenhar o post.
O easyCoexistence devolve o permalink de cada post conectado do Instagram por meio de list_social_posts, pronto para passar ao oEmbed, e permite que o Claude, o ChatGPT ou o seu próprio código publiquem, agendem e respondam comentários e DMs da conta pela API oficial da Meta.
Desde essa data, a API oEmbed do Instagram da Meta pode ser chamada sem token de acesso, em todas as versões.
Requisições por hora permitidas pelo guia de oEmbed da Meta.
A faixa que maxwidth aceita; maxheight não é suportado.
Quando author_name, author_url e os campos de thumbnail deixaram as respostas de oEmbed do Instagram, em todas as versões da API.
Posts de contas privadas, inativas ou com restrição de idade não são suportados pelo endpoint oEmbed.
Como funciona o endpoint oEmbed do Instagram?
Você envia a URL de um post público e recebe o HTML que o exibe. O endpoint roda no host principal da Graph API da Meta, o mesmo usado pelas chamadas do Facebook Login, e não em graph.instagram.com. A resposta é um pequeno objeto JSON cujo campo html vai para a página exatamente como está.
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>"
}Quais URLs ele aceita?
Três formatos, conforme o guia da Meta lista para o parâmetro url, que pode ser enviado puro ou codificado em URL. Os dois exemplos de requisição do guia mostram um de cada tipo:
- Posts de imagem única e carrossel: 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, quando o changelog da Meta diz que a API oEmbed do Instagram passou a poder ser chamada sem ele. Antes disso, os apps precisavam da funcionalidade Meta oEmbed Read aprovada na App Review e de um token em cada chamada, e o acesso com token continua funcionando. O guia de oEmbed da Meta permite até 1.000 requisições por hora, e o anúncio da Meta sobre o acesso sem token diz que apps com token podem ter limites de taxa maiores.
Quais parâmetros ele aceita?
Quatro, além de url, do guia da Meta e da referência dele:
- maxwidth: de 320 a 658; caso contrário, a incorporação é responsiva, e maxheight não é suportado.
- hidecaption: true oculta a legenda do post; o padrão é false.
- omitscript: true deixa o script fora do HTML, para páginas que carregam o embed.js uma vez por conta própria e chamam instgrm.Embeds.process().
- fields: limita a resposta aos campos nomeados.
O que a resposta contém?
Seis campos padrão: html, a marcação a exibir; version, sempre 1.0; provider_name e provider_url, que identificam o Instagram; type, o tipo de recurso oEmbed; e width, em pixels. Em 3 de novembro de 2025, a Meta removeu author_name, author_url, thumbnail_url, thumbnail_width e thumbnail_height das respostas de posts do Instagram, em todas as versões da API. Para posts da sua própria conta, a edge media ainda retorna username, permalink e thumbnail_url.
O que não pode ser incorporado?
O guia da Meta lista o que o endpoint deixa de fora, e uma regra de uso:
- Posts de contas privadas, inativas e com restrição de idade.
- Contas que desativaram as incorporações.
- Stories, e páginas que renderizam a incorporação dentro de um Shadow DOM.
- Qualquer uso além da exibição no front-end: a Meta proíbe expressamente usar os metadados ou o conteúdo do endpoint para outras finalidades.
Como incorporar os posts da sua própria conta?
Pegue o permalink de cada post e passe-o como url. Pelo easyCoexistence, list_social_posts devolve os posts recentes da conta conectada com seus permalinks, a partir do Claude, do ChatGPT ou do seu próprio código. Como a chamada oEmbed não precisa de token, seu site pode fazê-la diretamente.
Erros comuns
- Enviar um link de Story. O endpoint oEmbed da Meta não suporta Stories, então incorpore um post ou Reel.
- Ler thumbnail_url da resposta. A Meta a removeu, junto com author_name e os demais campos de thumbnail, em 3 de novembro de 2025.
- Definir maxwidth abaixo de 320 ou acima de 658. A Meta aceita apenas valores nessa faixa, e nenhum maxheight.
- Carregar o embed.js em cada incorporação. Com omitscript definido como true, carregue o script uma vez e chame instgrm.Embeds.process().
De US$ 9 a US$ 0.75 por conexão por mês, com queda 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
Posso incorporar um Reel do Instagram?
Sim. Passe a URL https://www.instagram.com/reel/{media-shortcode}/ e o endpoint devolve o HTML da incorporação.
A incorporação do Instagram é responsiva?
Sim. O guia da Meta diz que a incorporação é responsiva, e maxwidth define a largura máxima que ela pode ter.
Posso incorporar um perfil do Instagram?
Sim. O guia da Meta lista 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 permite o endpoint apenas para exibir o post em uma página ou app, e proíbe outros usos dos seus metadados e conteúdo.
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