Insights do Instagram pela API: métricas de conta e de posts
A API do Instagram retorna insights de uma conta profissional e de cada um dos seus posts, Reels e Stories. As métricas da conta incluem alcance, visualizações, contas engajadas, seguidores ganhos e perdidos, curtidas, comentários, salvamentos e compartilhamentos. As métricas de posts incluem alcance, visualizações, curtidas, comentários, salvamentos e compartilhamentos. A Meta avisa que os dados podem ter atraso de até 48 horas.
O easyCoexistence lê os insights do Instagram com get_social_insights, então você pode perguntar ao Claude ou ao ChatGPT como foram os posts da semana passada e receber alcance, visualizações, curtidas, comentários, salvamentos e compartilhamentos direto da Meta, da conta ou de um único post.
Quanto tempo os dados das métricas do Instagram podem atrasar.
Abaixo desse número, a conta não recebe seguidores ganhos e perdidos nem os dados demográficos de seguidores.
Por quanto tempo a Meta armazena as métricas de mídia.
Por quanto tempo as métricas de Stories ficam disponíveis pela API.
Quando a métrica impressions deixou de funcionar em todas as versões da API, exceto em mídias criadas antes de 2 de julho de 2024; views a substituiu.
Quais métricas da conta estão disponíveis?
São lidas com GET /<IG_ID>/insights, em geral com period=day e metric_type=total_value:
- reach: contas únicas que viram o conteúdo, incluindo anúncios; valor estimado.
- views: quantas vezes o conteúdo foi reproduzido ou exibido.
accounts_engaged: contas que interagiram com o conteúdo, incluindo anúncios; valor estimado.follows_and_unfollows: seguidores ganhos e perdidos no período; exige pelo menos 100 seguidores.- likes, comments, saves, shares, replies e reposts, além de
total_interactions. profile_links_taps: toques nos botões de endereço comercial, ligação, e-mail e mensagem de texto.follower_demographicseengaged_audience_demographics: idade, cidade, país e gênero.
Quais métricas de posts estão disponíveis?
São lidas com GET /<IG_MEDIA_ID>/insights; as métricas disponíveis dependem do formato. Em um post ou Reel, curtidas, comentários, visualizações e total de interações contam apenas a atividade orgânica, não o engajamento nos anúncios criados a partir dele.
- Posts e Reels: reach, views, likes, comments, saved, shares,
total_interactionse reposts. - Somente Reels:
ig_reels_avg_watch_time,ig_reels_video_view_total_timeereels_skip_rate. - Posts e Stories: follows,
profile_visitseprofile_activity. - Stories: reach, views, shares, replies, navigation, reposts e
total_interactions.
Como funcionam period, metric_type e os detalhamentos?
As métricas da conta usam period=day. metric_type=total_value retorna um único valor para o intervalo e é o que os detalhamentos exigem; time_series retorna um valor por dia e está disponível para reach. Os detalhamentos dividem um total por media_product_type (posts, carrosséis, Reels, Stories e anúncios), por follow_type (seguidores ou não) ou por contact_button_type.
As métricas demográficas usam um timeframe, como this_week ou this_month, em vez de since e until; sem since e until, as demais métricas consideram as últimas 24 horas. Pedir um detalhamento que uma das métricas solicitadas não aceita faz a requisição inteira falhar com um erro desconhecido.
Quais limites mínimos e atrasos se aplicam?
As regras da Meta sobre quando um número aparece e por quanto tempo ele fica disponível:
- Os dados podem ter atraso de até 48 horas.
- Contas com menos de 100 seguidores não recebem
follows_and_unfollowsnemfollower_demographics;engaged_audience_demographicsexige 100 engajamentos no timeframe. - Dados ausentes ou indisponíveis voltam como um conjunto vazio, não como 0.
- As métricas demográficas retornam apenas os 45 principais valores.
- As métricas da conta ficam armazenadas por até 90 dias; as métricas de mídia, por até 2 anos.
O que muda em Stories e carrosséis?
As métricas de Stories ficam disponíveis por apenas 24 horas, e um valor abaixo de 5 retorna o código de erro 10, not enough viewers, em vez de um número. Respostas de pessoas na Europa e no Japão ficam de fora, e um Story criado por uma conta dessas regiões informa 0 respostas. Com o Instagram Login não existe o webhook story_insights, então os números de Stories precisam ser lidos enquanto o Story está no ar.
Um carrossel conta como um único post: a Meta não retorna insights das fotos e dos vídeos dentro dele.
Por que os nomes das métricas mudam?
Porque a Meta aposenta e renomeia métricas entre versões da API. impressions foi descontinuada na v22.0 e deixou de funcionar em todas as versões em 21 de abril de 2025, exceto em mídias criadas antes de 2 de julho de 2024, e views entrou no lugar; plays, clips_replays_count e ig_reels_aggregated_all_plays_count saíram ao mesmo tempo. video_views e várias séries temporais de perfil, entre elas profile_views, foram removidas antes. Uma requisição com um nome aposentado falha, então uma lista de métricas escrita para uma versão anterior da API pode precisar de atualização.
Erros comuns
- Pedir impressions. A métrica não funciona mais em nenhuma versão da API; peça views no lugar.
- Tratar um resultado vazio como zero. A Meta retorna um conjunto de dados vazio quando uma métrica está indisponível, o que não é o mesmo que ausência de atividade.
- Ler as métricas de um Story depois que ele termina. Elas ficam disponíveis por apenas 24 horas.
- Adicionar um detalhamento a uma requisição de várias métricas. Se uma delas não o aceitar, a chamada inteira falha.
De R$ 29,90 a R$ 3,90 por conexão por mês, com o valor caindo conforme você adiciona conexões, e os 3 primeiros 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
O que substituiu impressions na API do Instagram?
views, que conta quantas vezes o conteúdo foi reproduzido ou exibido. A Meta aposentou impressions em todas as versões da API em 21 de abril de 2025, exceto em mídias criadas antes de 2 de julho de 2024.
Por que minha conta não retorna dados de seguidores?
A Meta não retorna follows_and_unfollows nem dados demográficos de seguidores para contas com menos de 100 seguidores.
Até quanto tempo atrás posso consultar os insights do Instagram?
Até 90 dias de métricas da conta e até 2 anos de métricas de mídia, sendo que online_followers cobre apenas os últimos 30 dias.
Os números incluem anúncios?
Em parte. O alcance e as contas engajadas de uma conta incluem anúncios, enquanto curtidas, comentários e visualizações de um post contam apenas a atividade orgânica.
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