Métricas do Instagram através da API: conta e publicações
A API do Instagram devolve métricas para uma conta profissional e para cada uma das suas publicações, Reels e Stories. As métricas da conta incluem alcance, visualizações, contas envolvidas, seguidores ganhos e perdidos, gostos, comentários, guardados e partilhas; as métricas das publicações incluem alcance, visualizações, gostos, comentários, guardados e partilhas. A Meta indica que os dados podem atrasar até 48 horas.
A easyCoexistence lê as métricas do Instagram com get_social_insights, por isso pode perguntar ao Claude ou ao ChatGPT como correram as publicações da semana passada e obter alcance, visualizações, gostos, comentários, guardados e partilhas diretamente da Meta, para a conta ou para uma única publicação.
Durante quanto tempo os dados por trás das métricas do Instagram podem atrasar.
Abaixo deste limite, não são devolvidos para a conta os seguidores ganhos e perdidos nem os dados demográficos dos seguidores.
Durante quanto tempo a Meta guarda as métricas dos conteúdos multimédia.
Durante quanto tempo as métricas das Stories continuam disponíveis através da API.
Quando as impressions deixaram de funcionar em todas as versões da API, exceto em conteúdos criados antes de 2 de julho de 2024; as views passaram a substituí-las.
Que métricas da conta estão disponíveis?
Lêem-se com GET /<IG_ID>/insights, sobretudo com period=day e metric_type=total_value:
- reach: contas únicas que viram o conteúdo, incluindo anúncios; valor estimado.
- views: número de vezes que o conteúdo foi reproduzido ou apresentado.
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, bem como
total_interactions. profile_links_taps: toques nos botões de morada, de chamada, de email e de mensagem da empresa.follower_demographicseengaged_audience_demographics: idade, cidade, país e género.
Que métricas das publicações estão disponíveis?
Lêem-se com GET /<IG_MEDIA_ID>/insights; as métricas aplicáveis dependem do formato. Numa publicação ou Reel, likes, comments, views e total_interactions contam apenas a atividade orgânica, e não o envolvimento em anúncios criados a partir dela.
- Publicações e Reels: reach, views, likes, comments, saved, shares,
total_interactionse reposts. - Apenas Reels:
ig_reels_avg_watch_time,ig_reels_video_view_total_timeereels_skip_rate. - Publicações e Stories: follows,
profile_visitseprofile_activity. - Stories: reach, views, shares, replies, navigation, reposts e
total_interactions.
Como funcionam period, metric_type e as desagregações?
As métricas da conta usam period=day. metric_type=total_value devolve um único valor para o intervalo e é o que as desagregações exigem; time_series devolve um valor por dia e está disponível para reach. As desagregações dividem um total por media_product_type (publicações, 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 restantes métricas olham para as últimas 24 horas. Pedir uma desagregação que uma das métricas pedidas não suporta faz falhar todo o pedido com um erro desconhecido.
Que limiares e atrasos se aplicam?
As regras da Meta sobre quando um número aparece e durante quanto tempo fica disponível:
- Os dados podem atrasar até 48 horas.
- Contas com menos de 100 seguidores não recebem
follows_and_unfollowsnemfollower_demographics;engaged_audience_demographicsexige 100 interações no período. - Dados em falta ou indisponíveis voltam como conjunto vazio, e não como 0.
- As métricas demográficas devolvem apenas os 45 valores principais.
- As métricas da conta são guardadas até 90 dias, e as dos conteúdos multimédia até 2 anos.
O que muda para as Stories e os carrosséis?
As métricas das Stories estão disponíveis apenas durante 24 horas, e um valor inferior a 5 devolve o código de erro 10 (not enough viewers) em vez de um número. As respostas de pessoas na Europa e no Japão ficam de fora, e uma Story criada por uma conta nessas regiões indica 0 respostas. Com o Instagram Login não existe o webhook story_insights, por isso os números das Stories têm de ser lidos enquanto a Story está no ar.
Um carrossel é contabilizado como uma única publicação: a Meta não devolve métricas para as fotos e vídeos que o compõem.
Porque mudam os nomes das métricas?
Porque a Meta retira e renomeia métricas entre versões da API. impressions foi descontinuada na v22.0 e deixou de funcionar em todas as versões a 21 de abril de 2025, exceto em conteúdos criados antes de 2 de julho de 2024; em seu lugar foi introduzida views. Em simultâneo, deixaram de existir plays, clips_replays_count e ig_reels_aggregated_all_plays_count. video_views e várias séries temporais de perfil, entre elas profile_views, tinham sido retiradas antes. Um pedido com um nome retirado falha, por isso uma lista de métricas escrita para uma versão anterior da API pode precisar de atualização.
Erros comuns
- Pedir impressions. Deixou de funcionar em todas as versões da API; pedir views no seu lugar.
- Tratar um resultado vazio como zero. A Meta devolve um conjunto de dados vazio quando uma métrica não está disponível, o que não equivale a ausência de atividade.
- Ler as métricas de uma Story depois de ela terminar. Estão disponíveis apenas durante 24 horas.
- Acrescentar uma desagregação a um pedido com várias métricas. Se uma delas não a suportar, a chamada inteira falha.
De US$ 9 a US$ 0.75 por ligação por mês, descendo à medida que acrescenta ligações, com os primeiros 3 dias grátis.
Perguntas frequentes
O que substituiu impressions na API do Instagram?
views, que conta as vezes em que o conteúdo foi reproduzido ou apresentado. A Meta retirou impressions em todas as versões da API a 21 de abril de 2025, exceto em conteúdos criados antes de 2 de julho de 2024.
Porque é que a minha conta não devolve dados de seguidores?
A Meta não devolve follows_and_unfollows nem dados demográficos de seguidores para contas com menos de 100 seguidores.
Até quando posso consultar as métricas do Instagram?
Até 90 dias de métricas da conta e até 2 anos de métricas de conteúdos multimédia, sendo que online_followers abrange apenas os últimos 30 dias.
Os números incluem anúncios?
Em parte. O alcance e as contas envolvidas de uma conta incluem anúncios, ao passo que os gostos, comentários e visualizações de uma publicação contam apenas atividade orgânica.
Continue a ler
Ligue o seu primeiro canal em dois minutos.
Sem revisões de plataformas para esperar. Ligue o WhatsApp, o Instagram, o TikTok ou outro canal, peça depois à sua IA que publique, responda ou faça um relatório, e veja-a trabalhar.
- 3 dias grátis
- Cancele quando quiser
- Só APIs oficiais
- Monitorizado 24/7
Verificado em