API do Instagram em 2026: como acessar as métricas de contas profissionais
O caminho oficial para ler alcance, impressões e insights de perfis do Instagram dos seus clientes, passo a passo, e o que muda entre as duas versões da API.
Conferido na documentação oficial em 27/10/2026.
As duas versões da API do Instagram
A Meta oferece a API do Instagram de duas formas. Elas leem os mesmos tipos de dado, mas o login e as permissões são diferentes.
| Com login do Instagram | Com login do Facebook | |
|---|---|---|
| Endereço | graph.instagram.com | graph.facebook.com |
| Página do Facebook | Não precisa | Precisa estar vinculada ao perfil |
| Permissões de insights | instagram_business_basic e instagram_business_manage_insights | instagram_basic, instagram_manage_insights e pages_read_engagement |
Nas duas, só contas profissionais (empresa ou criador de conteúdo) funcionam. A API não lê dados de contas pessoais, e algumas métricas não existem em perfis com menos de 100 seguidores.
Acesso avançado, revisão de app e verificação da empresa
Para ler perfis que você não administra, como os dos seus clientes, o app precisa de acesso avançado às permissões. Esse acesso exige duas etapas:
- Revisão de app pela Meta, em que você mostra como cada permissão é usada no seu produto.
- Verificação da empresa no Gerenciador de Negócios, obrigatória desde fevereiro de 2023.
Tokens e renovação
- O código de autorização e o token de curta duração valem 1 hora.
- O token de longa duração vale 60 dias.
- Ele pode ser renovado depois de ter pelo menos 24 horas e antes de vencer. Se vencer, o cliente precisa autorizar o perfil de novo.
Passo a passo resumido
- Criar um app no Meta for Developers.
- Escolher a versão da API: login do Instagram ou login do Facebook.
- Adicionar as permissões de insights da versão escolhida.
- Concluir a verificação da empresa.
- Enviar o app para a revisão da Meta e esperar a aprovação do acesso avançado.
- Implementar o login, trocar o token curto pelo de 60 dias e guardar o token de cada perfil.
- Renovar cada token antes de vencer e avisar o cliente quando um perfil perder o acesso.
Perguntas frequentes
Dá para usar a API do Instagram com conta pessoal?
Não. A API de insights só funciona com contas profissionais, de empresa ou de criador de conteúdo.
Quanto tempo vale o token do Instagram?
O token de longa duração vale 60 dias e pode ser renovado depois de 24 horas, enquanto ainda estiver válido.
Preciso de Página do Facebook?
Só na versão com login do Facebook. Na versão com login do Instagram, a Página não é necessária.
