EntrarComeçar teste grátis
easyCoexistence APIs oficiais

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.

3 setups

Configurações da API do Instagram na visão geral da Meta: Unified Login, Instagram Login e Facebook Login.

23 Jul 2024

Lançamento da API do Instagram com Instagram Login: não exige Página vinculada, e as chamadas vão para graph.instagram.com.

4 Dec 2024

A Meta descontinuou a Instagram Basic Display API; o changelog dela diz que as requisições a ela retornam uma mensagem de erro.

Unified Login

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.

Professional

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:

Instagram API with Instagram LoginBusiness Login for Instagram, an Instagram User access token, graph.instagram.com and the instagram_business_* permissions; no Page needed
Instagram API with Facebook LoginFacebook Login for Business, a user or Page access token, the instagram_* and Page permissions; the account must be linked to a Page
Instagram API with Unified LoginFacebook Login for Business, which also accepts Instagram credentials, a Business Integration System User access token and a business portfolio; no Page needed

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 LoginFacebook Login
Content publishingSupportedSupported
Comment moderationSupportedSupported
MentionsSupportedSupported
InsightsSupportedSupported
MessagingSupportedSupported, through a separate messaging API
Hashtag searchNot supportedSupported
Business DiscoveryNot listedSupported
Product taggingNot supportedSupported
Partnership adsNot supportedSupported

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.

Two first calls with Instagram Login
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.
Fazendo isso com o EasyCoexistence

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