Métricas descontinuadas da API do Instagram: impressions e plays substituídas por views
A Meta substituiu impressions por views na API de estatísticas do Instagram. Introduziu views a 21 de janeiro de 2025 e descontinuou impressions, plays, clips_replays_count e ig_reels_aggregated_all_plays_count em todas as versões da API a 21 de abril de 2025, depois de video_views e seis métricas da conta terem terminado a 8 de janeiro. Alterações posteriores acrescentaram métricas, como reposts e reels_skip_rate em dezembro de 2025.
O easyCoexistence lê as estatísticas do Instagram com get_social_insights, que passa diretamente à Meta os nomes de métricas que indica, views incluída, e devolve os dados da Meta ou a própria mensagem de erro da Meta quando um nome está retirado, para que o Claude, o ChatGPT ou o seu próprio código possa acompanhar uma mudança de nome no dia em que a Meta a faz.
Quando impressions, plays, clips_replays_count e ig_reels_aggregated_all_plays_count foram descontinuadas em todas as versões da API.
Quando a Meta introduziu views para as estatísticas da conta e das publicações, e abriu as estatísticas às aplicações com Instagram Login.
Quando video_views e seis séries temporais da conta, profile_views e website_clicks entre elas, deixaram de ser suportadas em todas as versões.
As publicações criadas nesta data ou depois devolvem um erro, e não dados, quando se pede impressions depois de 21 de abril de 2025.
O único metric_type aceite pela métrica views ao nível da conta; impressions também oferecia uma time_series diária.
Que métricas do Instagram a Meta descontinuou em 2025?
Duas fases, cada uma anunciada com meses de antecedência no registo de alterações da Meta, e aplicada primeiro a partir de uma nova versão da Graph API, depois a todas as versões:
- 8 de janeiro de 2025:
video_viewsnas publicações, e as séries temporais da contaemail_contacts,get_direction_clicks,phone_call_clicks,profile_views,text_message_clicksewebsite_clicks, removidas primeiro na v21.0. - 21 de janeiro de 2025: impressions nas estatísticas da conta e das publicações, e plays,
clips_replays_counteig_reels_aggregated_all_plays_countnas publicações, descontinuadas a partir da v22.0 e seguintes, no dia em que views chegou. - 21 de abril de 2025: estas quatro descontinuadas em todas as versões da API.
O que deve substituir cada métrica retirada?
A Meta associou views às retiradas de abril de 2025 na mesma entrada do registo de alterações. Para as de janeiro não indicou nenhum sucessor, pelo que a coluna da direita apresenta a métrica mais próxima que as referências da conta e das publicações documentavam a 31 de outubro de 2026.
| Retired | Request instead | |
|---|---|---|
| impressions | Account and media, 21 Apr 2025 | views |
| plays | Media, 21 Apr 2025 | views |
| clips_replays_count | Media, 21 Apr 2025 | views |
| ig_reels_aggregated_all_plays_count | Media, 21 Apr 2025 | views |
| video_views | Media, 8 Jan 2025 | views |
| phone_call_clicks, email_contacts, text_message_clicks, get_direction_clicks | Account, 8 Jan 2025 | profile_links_taps, by contact_button_type |
| profile_views | Account, 8 Jan 2025 | profile_visits, per post or Story |
| website_clicks | Account, 8 Jan 2025 | profile_activity per post, whose action_type includes BIO_LINK_CLICKED |
Impressions ainda devolve alguma coisa?
Só para publicações antigas. O registo de alterações da Meta diz que os pedidos feitos depois de 21 de abril de 2025 para publicações criadas em ou após 2 de julho de 2024 devolvem um erro, e a referência de estatísticas das publicações mantém impressions apenas para publicações criadas antes dessa data. Na conta, impressions está descontinuada em todas as versões, pelo que o código escrito hoje não tem utilidade para ela.
O que conta views?
Na conta, o número de vezes que o conteúdo foi reproduzido ou apresentado, em Reels, publicações e Stories; numa única publicação, Reel ou Story, o número de vezes que foi reproduzido no Instagram. impressions contava as vezes que o conteúdo esteve no ecrã, anúncios incluídos, por isso um gráfico que passe de uma para a outra muda o que mede na troca. A métrica views ao nível da conta aceita apenas metric_type=total_value e desagrega por media_product_type, e a Meta ainda a assinala como em desenvolvimento.
Que métricas a Meta acrescentou desde então?
O registo de alterações da Meta lista estas adições depois das retiradas de 2025:
- 3 de dezembro de 2025:
reels_skip_ratee reposts nas publicações, reposts na conta, ecrossposted_viewsefacebook_viewspara Reels crossposted. - 22 de abril de 2026:
total_likes,total_commentsetotal_views, agregadas entre superfícies e incluindo publicações promovidas, que a referência da Meta oferece apenas com Facebook Login;facebook_viewstambém alargada a publicações e Stories. - 22 de junho de 2026:
link_clicksem Stories, contando toques em ligações como os autocolantes de ligação, que o registo limita ao Facebook Login.
O que tem de mudar no código?
Uma lista de métricas escrita antes de 2025 precisa destas alterações para continuar a funcionar:
- Substitua impressions, plays,
clips_replays_count,ig_reels_aggregated_all_plays_countevideo_viewspor views, tanto nos pedidos à conta como às publicações. - Peça views ao nível da conta com
metric_type=total_value. Não temtime_series, por isso leia um total por intervalo onde antes impressions dava uma linha diária. - Peça
crossposted_viewsefacebook_viewsapenas em publicações crossposted, num pedido à parte: a referência da Meta diz que ambas devolvem erro quando a publicação não foi crossposted. - Não inclua
total_likes,total_commentsetotal_viewsnas aplicações com Instagram Login, uma vez que a Meta as oferece apenas com Facebook Login. - Substitua
phone_call_clicks,email_contacts,text_message_clickseget_direction_clicksporprofile_links_tapsdesagregado porcontact_button_type. - Trate um erro num nome de métrica como um sinal para atualizar a lista, e não para repetir o pedido.
Como chegam as descontinuações às versões mais antigas da API?
Em duas etapas. Uma alteração aplica-se primeiro a partir de uma nova versão da Graph API, a v21.0 para video_views e a v22.0 para impressions, e depois chega a todas as versões numa data indicada na mesma entrada do registo de alterações, cerca de três meses depois em ambos os casos. Fixar uma versão antiga ganha no máximo uns meses, e o registo de alterações da Instagram Platform da Meta indica as duas datas de cada alteração.
Que retiradas anteriores ainda afetam código antigo?
Duas de antes de 2025 aparecem em código que não é tocado há muito:
- 11 de dezembro de 2023: as métricas de
carousel_album,taps_forward,taps_back, exits e engagement nas publicações, eaudience_gender_age,audience_locale,audience_countryeaudience_cityna conta, ondefollower_demographicsagora cobre idade, cidade, país e género. - 19 de agosto de 2024: os intervalos
last_14_days,last_30_days,last_90_dayseprev_monthparaengaged_audience_demographicsereached_audience_demographics;this_weekethis_monthmantêm-se.
Erros comuns
- Pedir impressions para uma publicação publicada desde julho de 2024. A Meta devolve um erro para essa publicação; peça views.
- Pedir views da conta como time_series. A Meta documenta-a apenas com total_value, por isso leia um total para cada intervalo de que precisa.
- Pedir crossposted_views ou facebook_views para publicações que nunca foram crossposted. A referência da Meta diz que ambas devolvem erro nesse caso.
- Esperar total_likes, total_comments ou total_views com Instagram Login. A Meta disponibiliza-as apenas com Facebook Login; likes, comments e views mantêm-se.
De US$ 9 a US$ 0.75 por ligação por mês, a descer à medida que adiciona ligações, com os primeiros 3 dias gratuitos.
Perguntas frequentes
O que substituiu phone_call_clicks e email_contacts na API do Instagram?
A Meta não indicou um sucessor direto quando terminaram em todas as versões a 8 de janeiro de 2025. A métrica mais próxima que a referência da conta documenta hoje é profile_links_taps, desagregada por contact_button_type.
O que substituiu plays nos Reels do Instagram?
views. A Meta descontinuou plays, clips_replays_count e ig_reels_aggregated_all_plays_count em todas as versões da API a 21 de abril de 2025, três meses depois de introduzir views.
Porque começou a falhar o meu pedido de estatísticas do Instagram?
Verifique primeiro a lista de métricas: impressions, plays, video_views e as antigas métricas de perfil estão descontinuadas, e views ao nível da conta aceita apenas total_value. Repetir o mesmo pedido devolve o mesmo erro.
A Meta retirou alguma métrica do Instagram em 2026?
Nenhuma aparece no registo de alterações do Instagram da Meta até 28 de outubro de 2026. As entradas de 2026 acrescentam métricas, entre elas total_views, um facebook_views mais alargado e link_clicks em Stories.
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