A API Instagram Basic Display acabou: o que usar no lugar

A Meta descontinuou a API Instagram Basic Display em 4 de dezembro de 2024, e as requisições agora retornam erro. O que a substitui depende da conta: a API do Instagram com Instagram Login para contas profissionais, o endpoint oEmbed para incorporar posts públicos, e para uma conta pessoal comum, nada. Changelog conferido em 22 de outubro de 2026.

O que de fato aconteceu com a API Basic Display

O changelog da plataforma do Instagram traz a entrada em 4 de dezembro de 2024: «The Instagram Basic Display API has been deprecated.» As requisições retornam erro em vez de dados. Não sobrou nenhum período de carência para planejar, e nenhum ajuste no App Dashboard a traz de volta.

A Basic Display era a fácil. Ela lia o perfil, a mídia e as legendas de um usuário com uma conta pessoal do Instagram, sem Página do Facebook, sem converter para conta profissional, e com uma revisão que a maioria dos projetos pessoais passava. É exatamente por isso que ela ainda está em toda resposta do Stack Overflow, em pacotes npm e em tutoriais datados de 2023. Se a sua integração quebrou e você foi procurar a correção, provavelmente achou três deles antes de chegar aqui.

Mais duas datas do mesmo changelog contam enquanto você migra. Os valores antigos de scope foram descontinuados em 27 de janeiro de 2025, substituídos pela família instagram_business_*. E o recurso oEmbed Read está descontinuado desde 3 de novembro de 2025, com vários campos de resposta do oEmbed removidos.

O que usar no lugar, caso a caso

O padrão é o que a Meta segue em toda a plataforma dela desde 2023: existem APIs para as contas que são um negócio, e a API de leitura de contas pessoais foi embora de vez.

API do Instagram com Instagram Login: a substituta de verdade

É aqui que quase todo mundo chega. Ela cobre contas profissionais do Instagram, de empresa e de criador, e não exige uma Página do Facebook ligada, que é justamente o que faz dela uma sucessora de verdade e não um desvio. As credenciais são do próprio Instagram e o host é graph.instagram.com, pelo fluxo que a Meta chama de Business Login for Instagram.

Quatro scopes cobrem toda a superfície:

• instagram_business_basic, sempre obrigatório
• instagram_business_content_publish, para publicar mídia
• instagram_business_manage_comments, para ler, responder, ocultar e apagar comentários
• instagram_business_manage_messages, para DMs

O guia de migração da Meta descreve isso como duas permissões por tarefa: o scope básico mais o scope específico de mensagens, moderação de comentários ou publicação. As capacidades oferecidas são moderação de comentários, publicação de conteúdo, insights de mídia, menções e mensagens. Os limites documentados valem a leitura antes de você planejar: essa configuração não acessa anúncios nem marcação.

Então a migração não é trocar um host em uma linha. Você muda o tipo de conta, o fluxo de login, os nomes dos scopes e a revisão de permissões, e ganha um acesso de escrita que não tinha. Se o que te preocupa são os tokens, escrevi todo o ciclo de vida deles em tokens de acesso de redes sociais.

API do Instagram com Facebook Login: o caminho ligado a uma Página

Se a conta já está conectada a uma Página do Facebook e seu app tem credenciais de Página, essa é a variante que vale manter. Ela roda com credenciais do Facebook contra a Graph API, e a Meta a posiciona para integrações já existentes ligadas a uma Página, não para projetos novos. O conjunto de capacidades se sobrepõe muito ao do Instagram Login; a diferença é por qual login o usuário passa e se uma Página precisa existir.

Escolha essa quando uma Página já faz parte do produto, por exemplo porque você também publica no Facebook. Escolha o Instagram Login quando o usuário só tem Instagram e você não quer explicar por que seu app está perguntando sobre o Facebook. A superfície completa das duas, com os endpoints e os limites de requisição, está em a API Instagram Graph em 2026.

Incorporar posts públicos: oEmbed, com ressalvas

Se tudo o que você fazia com a Basic Display era colocar um post em uma página web, o endpoint que você quer é GET /instagram_oembed em graph.facebook.com. Ele devolve o HTML de incorporação para fotos, vídeos, Reels e posts do feed, até 1.000 requisições por hora.

O que ele não vai fazer é mais longo que o que ele faz. Ele não serve contas privadas, inativas ou com restrição de idade, contas que desligaram as incorporações, Stories, nem nada dentro de um Shadow DOM. E pela entrada de changelog de 8 de abril de 2025, o recurso oEmbed Read está descontinuado desde 3 de novembro de 2025, com campos de resposta removidos. Trate como caminho de manutenção, não como alicerce.

API do Instagram para conta pessoal: essa versão não existe

Essa é a resposta honesta que ninguém que escreve sobre a Basic Display quer dar. Não existe API que leia a mídia de uma conta pessoal do Instagram. A Basic Display era isso, e está desligada. Suas opções são pedir ao usuário que mude para conta profissional, o que é grátis e reversível no app do Instagram, ou tirar o recurso.

O que você não pode fazer é recorrer a um scraper ou a uma biblioteca não oficial que faz login como o usuário. Isso é violação direta dos Platform Terms da Meta, e a conta que paga é a do seu usuário, não a sua. Contei o que dispara um flag e por que em automação no Instagram em 2026.

Um checklist de migração que cabe em uma tela

1. Decida o tipo de conta que você vai atender. A profissional libera tudo, a pessoal não libera nada.
2. Registre o produto no seu app da Meta: API do Instagram com Instagram Login, ou com Facebook Login se já houver uma Página na jogada.
3. Troque os valores antigos de scope pelos nomes instagram_business_*. Os antigos saíram em 27 de janeiro de 2025.
4. Reconstrua o login como Business Login for Instagram e guarde o token que você recebe, não o que seu código antigo esperava.
5. Envie para App Review os scopes que você realmente usa. Publicação e mensagens são revisadas separadamente das leituras básicas.
6. Confira o changelog antes de subir para produção. Três das datas deste artigo foram descontinuações anunciadas meses antes do corte.

Se você prefere não carregar nada disso, esse é o trabalho que o PlugKit faz: uma API e um servidor MCP hospedado em Instagram, Facebook, LinkedIn, TikTok, YouTube, X, WhatsApp e Telegram, com os fluxos OAuth, a renovação de tokens e as esquisitices de cada plataforma do nosso lado. US$ 49 por mês para 5 contas conectadas, cancela quando quiser. Ele só fala com contas profissionais do Instagram, porque é a única coisa com que a API oficial fala. Para o lado dos agentes, veja o servidor MCP do Instagram.

Perguntas frequentes

A API Instagram Basic Display ainda está disponível?

Não. O changelog da plataforma do Instagram registra como descontinuada em 4 de dezembro de 2024, e as requisições retornam erro. Não há prorrogação nem modo legado.

O que substituiu a Instagram Basic Display API?

A API do Instagram com Instagram Login, para contas profissionais do Instagram, de empresa e de criador, sem exigir Página do Facebook. Ela cobre publicação, comentários, mensagens, insights de mídia e menções, e diferente da Basic Display ela escreve, não só lê.

Posso usar a API do Instagram com uma conta pessoal?

Não. Toda API atual do Instagram exige uma conta profissional, de empresa ou de criador. A Basic Display era o único caminho para uma conta pessoal e acabou. Mudar para conta profissional no app do Instagram não custa nada e dá para desfazer.

Ainda preciso de uma Página do Facebook para usar a API do Instagram?

Não com a API do Instagram com Instagram Login, que autentica com credenciais do Instagram contra graph.instagram.com. Uma Página só é necessária para a API do Instagram com Facebook Login e para o suporte da Messenger API para Instagram.

Ainda consigo incorporar posts do Instagram sem chave de API?

O endpoint oEmbed GET /instagram_oembed devolve o HTML de incorporação para fotos, vídeos, Reels e posts do feed públicos, até 1.000 requisições por hora. Ele não funciona com contas privadas nem com Stories, e o recurso Read dele está descontinuado desde 3 de novembro de 2025, então conte que ele vai continuar encolhendo.

AB

Antoine BlancoFundador da PlugKit. Gerencia as próprias contas de Instagram, YouTube e X pela API e pelo servidor MCP descritos aqui.