O que é a Instagram Graph API? A API do Instagram em 2026
A Instagram Graph API é a API do Instagram da Meta: o conjunto de APIs para contas profissionais do Instagram, comerciais ou de criador, cujas URLs de referência ainda levam o nome Graph API. A Meta agora documenta três configurações: a API do Instagram com Instagram Login, que chama graph.instagram.com, com Facebook Login e com Unified Login, recomendada para novas integrações. Apps a usam para publicar, moderar comentários, responder mensagens diretas e ler insights.
O easyCoexistence roda sobre a API do Instagram com Instagram Login: o dono da conta entra com o Instagram uma vez, e Claude, ChatGPT ou sua própria plataforma publicam e agendam publicações, respondem a comentários e mensagens diretas e leem insights pela API oficial da Meta, com cada conexão monitorada 24/7.
Configurações da API do Instagram na visão geral da Meta: Unified Login, Instagram Login e Facebook Login.
Lançamento da API do Instagram com Instagram Login: não exige Página vinculada, e as chamadas vão para graph.instagram.com.
A Meta descontinuou a Instagram Basic Display API; o changelog dela diz que as requisições a ela retornam uma mensagem de erro.
A configuração que a Meta recomenda para novas integrações, e a única em que novos recursos da API do Instagram são lançados.
O tipo de conta atendido pela Instagram Platform: conta comercial ou de criador.
O que a Meta chama agora de Instagram Graph API?
A Instagram Platform, que a visão geral da Meta descreve como um conjunto de APIs para contas profissionais do Instagram, dividido em três configurações conforme a forma como o dono da conta faz login. O nome Graph API sobrevive nas URLs de referência, sob instagram-graph-api, e na nota da visão geral de que o recurso Instagram Public Content Access libera os endpoints de Hashtag Search da Instagram Graph API. A referência descreve nós como IG User e IG Media, seus campos, solicitados com fields=, e arestas como /media e /stories.
Quais configurações a Meta documenta?
Três. Elas diferem na forma como o dono da conta faz login, no token que o app recebe e no host que ele chama, mas todas atendem contas profissionais. A visão geral da Meta recomenda o Unified Login para novas integrações e mantém o Instagram Login e o Facebook Login para as existentes:
O que a API cobre?
A visão geral da Meta responde capacidade por capacidade. O Unified Login aparece marcado como Supported em cada linha; as outras duas configurações diferem como abaixo, e o guia Business Discovery da Meta acrescenta que consultar outras contas funciona com Facebook Login e Unified Login:
| Instagram Login | Facebook Login | |
|---|---|---|
| Content publishing | Supported | Supported |
| Comment moderation | Supported | Supported |
| Mentions | Supported | Supported |
| Insights | Supported | Supported |
| Messaging | Supported | Supported, through a separate messaging API |
| Hashtag search | Not supported | Supported |
| Business Discovery | Not listed | Supported |
| Product tagging | Not supported | Supported |
| Partnership ads | Not supported | Supported |
Qual é a relação com a Basic Display API?
A Basic Display deixou de existir. A Meta a descontinuou em 4 de dezembro de 2024, o changelog dela diz que as requisições retornam uma mensagem de erro, e a Meta recomenda migrar para a API do Instagram. A configuração com Instagram Login dessa API foi lançada em 23 de julho de 2024, eliminando a Página vinculada exigida pelas configurações anteriores. Contas pessoais ficam sem API, já que a visão geral da Meta exige uma conta profissional, comercial ou de criador.
Quais contas ela atende?
Contas profissionais do Instagram, que a Meta diz poderem representar uma empresa ou um criador. Instagram Login e Unified Login atendem contas sem Página vinculada; o Facebook Login atende contas vinculadas a uma Página, e quem faz login precisa poder executar tarefas equivalentes às de administrador nessa Página. O Standard Access cobre contas que você possui ou gerencia, e atender outras contas exige o Advanced Access, por meio de App Review e Business Verification.
Como é a primeira chamada?
Com o Instagram Login, depois que o dono da conta fez login e o app tem um token, GET /me com user_id e username retorna o IG_ID da conta, que o guia da Meta diz ser também o id nas suas notificações de webhook. GET /<IG_ID>/media então lista as publicações pelo ID, com cursores before e after para a próxima página.
GET https://graph.instagram.com/me
?fields=user_id,username
&access_token=<ACCESS_TOKEN>
GET https://graph.instagram.com/<IG_ID>/media
?access_token=<ACCESS_TOKEN>Como você usa a API pelo easyCoexistence?
O easyCoexistence conecta contas pela API do Instagram com Instagram Login e mantém o app da Meta, então o dono da conta entra com o Instagram e aprova as permissões. Claude, ChatGPT ou o seu próprio código então chamam ferramentas como publish_instagram_post, list_social_posts e get_social_insights, que adicionam o token da conta; get_social_credentials retorna o ID da conta e a base da API, nunca o token.
Erros comuns
- Seguir um guia de Facebook Login com um token de Instagram Login. Hosts, tokens e nomes de permissão diferem entre as configurações, então combine o guia com a configuração que o app usa.
- Apontar a API para uma conta pessoal. As configurações da Meta atendem contas profissionais, então mude para comercial ou de criador no app do Instagram antes.
- Copiar exemplos da Basic Display. Os endpoints dela retornam erros desde 4 de dezembro de 2024; leia a conta com GET /me e as publicações com /<IG_ID>/media.
- Planejar busca por hashtag com Instagram Login. A visão geral da Meta marca isso como não suportado nessa configuração; é preciso Facebook Login ou Unified Login.
De US$ 9 a US$ 0.75 por conexão por mês, caindo conforme você adiciona conexões, 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
A Instagram Graph API é a mesma coisa que a API do Instagram?
Sim. A documentação da Meta agora diz API do Instagram, em configurações nomeadas pelo login que cada uma usa, e mantém o caminho instagram-graph-api nas URLs de referência.
A API do Instagram exige uma Página vinculada?
Não com Instagram Login ou Unified Login. O Facebook Login é a configuração que exige que a conta profissional esteja vinculada a uma Página.
Qual configuração uma nova integração com o Instagram deve usar?
O Unified Login, pela recomendação da Meta, e a Meta lança novos recursos da API do Instagram só ali. O guia de migração da Meta diz que apps recém-criados não podem configurar o Instagram Login, enquanto as integrações existentes com Instagram Login continuam funcionando, sem data de término anunciada.
Quanto custa o easyCoexistence para uma conta do Instagram?
Cada conta do Instagram é uma conexão, cobrada de US$ 9 a US$ 0.75 por mês conforme o número de conexões que você tem, e os primeiros 3 dias são grátis.
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