Iniciar sessãoIniciar teste gratuito
easyCoexistence APIs oficiais

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.

21 Apr 2025

Quando impressions, plays, clips_replays_count e ig_reels_aggregated_all_plays_count foram descontinuadas em todas as versões da API.

21 Jan 2025

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.

8 Jan 2025

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.

2 Jul 2024

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.

total_value

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_views nas publicações, e as séries temporais da conta email_contacts, get_direction_clicks, phone_call_clicks, profile_views, text_message_clicks e website_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_count e ig_reels_aggregated_all_plays_count nas 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.

RetiredRequest instead
impressionsAccount and media, 21 Apr 2025views
playsMedia, 21 Apr 2025views
clips_replays_countMedia, 21 Apr 2025views
ig_reels_aggregated_all_plays_countMedia, 21 Apr 2025views
video_viewsMedia, 8 Jan 2025views
phone_call_clicks, email_contacts, text_message_clicks, get_direction_clicksAccount, 8 Jan 2025profile_links_taps, by contact_button_type
profile_viewsAccount, 8 Jan 2025profile_visits, per post or Story
website_clicksAccount, 8 Jan 2025profile_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_rate e reposts nas publicações, reposts na conta, e crossposted_views e facebook_views para Reels crossposted.
  • 22 de abril de 2026: total_likes, total_comments e total_views, agregadas entre superfícies e incluindo publicações promovidas, que a referência da Meta oferece apenas com Facebook Login; facebook_views também alargada a publicações e Stories.
  • 22 de junho de 2026: link_clicks em 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_count e video_views por views, tanto nos pedidos à conta como às publicações.
  • Peça views ao nível da conta com metric_type=total_value. Não tem time_series, por isso leia um total por intervalo onde antes impressions dava uma linha diária.
  • Peça crossposted_views e facebook_views apenas 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_comments e total_views nas aplicações com Instagram Login, uma vez que a Meta as oferece apenas com Facebook Login.
  • Substitua phone_call_clicks, email_contacts, text_message_clicks e get_direction_clicks por profile_links_taps desagregado por contact_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, e audience_gender_age, audience_locale, audience_country e audience_city na conta, onde follower_demographics agora cobre idade, cidade, país e género.
  • 19 de agosto de 2024: os intervalos last_14_days, last_30_days, last_90_days e prev_month para engaged_audience_demographics e reached_audience_demographics; this_week e this_month mantê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.
Fazer isto com a EasyCoexistence

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