A Graph API é a API HTTP da Meta para o Facebook e o Instagram. Se um software publica um post, lê estatísticas ou gerencia uma conta em qualquer uma das duas plataformas, ele passa pela Graph API. Para um exemplo prático, veja como publicar pela Graph API do Instagram. O nome vem do "grafo social" da Meta: pessoas, páginas e posts como nós conectados entre si.
// 01
Para que serve
No Instagram, a Graph API cobre as contas profissionais: publicar posts por meio de contêineres de mídia, ler estatísticas da conta e gerenciar os dados dela. O acesso exige uma autorização OAuth com os scopes certos, e as permissões que seu app pode solicitar dependem do processo de revisão de apps da Meta.
// 02
Trabalhar com a Graph API
A Graph API tem versões, e cada versão tem data de desativação, então as integrações precisam de manutenção regular à medida que campos e permissões mudam entre versões. Ela também impõe seus próprios limites de requisições por app e por usuário. Essa carga de manutenção explica em grande parte por que existem as APIs unificadas: elas acompanham as mudanças da Meta para que cada produto construído em cima não precise fazer isso.
// 03
A Instagram Graph API é gratuita?
A Meta não publica nenhuma taxa de uso. O que você paga é cumprir os requisitos e respeitar os limites: uma conta profissional do Instagram, a App Review da Meta antes de seu app receber Advanced Access, 4.800 chamadas por impressão em uma janela de 24 horas e 100 publicações feitas pela API por conta em 24 horas. O custo real é o trabalho de engenharia, detalhado em quanto custa a API do Instagram.
// 04
A Instagram Graph API e o Instagram Login não são a mesma API
A documentação da Meta agora agrupa suas APIs do Instagram no Instagram Platform, e há duas APIs diferentes para escolher, cada uma com sua própria configuração:
- A Instagram Graph API, usada pelo Facebook Login for Business. A conta do Instagram precisa ser Business ou Creator e estar vinculada a uma página do Facebook, e as requisições vão para a Graph API.
- A Instagram API with Instagram Login, uma variante independente que a Meta lançou em julho de 2024. Ela remove o requisito da página do Facebook, usa graph.instagram.com como host e tem seus próprios scopes de permissões, como instagram_business_basic e instagram_business_content_publish.
Escolha uma antes de começar, porque o host, os scopes e o fluxo de login são diferentes. Ambas são oficiais. As ferramentas que fazem login como o usuário não são, e colocam a conta em risco. Se você preferir não construir nenhum dos fluxos de login, a API de publicação no Instagram cuida da conexão da conta para você.
Passe da definição para a documentação que mostra como aplicá-lo.
Solução principal Conectar uma conta de Instagram