EntrarComeçar teste grátis
easyCoexistence APIs oficiais

API do Instagram: métricas descontinuadas, impressões e reproduções trocadas por visualizações

A Meta substituiu impressions por views na API de insights do Instagram. Introduziu views em 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 em 21 de abril de 2025, depois que video_views e seis métricas de conta deixaram de ter suporte em 8 de janeiro. Mudanças posteriores acrescentaram métricas, como reposts e reels_skip_rate, em dezembro de 2025.

easyCoexistence lê os insights do Instagram com get_social_insights, que repassa diretamente à Meta os nomes de métricas informados, views incluída, e devolve os dados da Meta ou a própria mensagem de erro dela quando um nome foi aposentado, para que Claude, ChatGPT ou seu próprio código acompanhe uma renomeação no dia em que a Meta a fizer.

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 insights de conta e de mídia, e abriu os insights para apps de Instagram Login.

8 Jan 2025

Quando video_views e seis séries temporais de conta, entre elas profile_views e website_clicks, perderam suporte em todas as versões.

2 Jul 2024

Mídia criada em ou após esta data retorna um erro, e não dados, quando impressions é pedido após 21 de abril de 2025.

total_value

O único metric_type que a métrica views no nível da conta aceita; impressions também oferecia uma time_series diária.

Quais métricas do Instagram a Meta aposentou em 2025?

Duas rodadas, cada uma anunciada com meses de antecedência no changelog 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 na mídia e as séries temporais de conta email_contacts, get_direction_clicks, phone_call_clicks, profile_views, text_message_clicks e website_clicks, retiradas primeiro na v21.0.
  • 21 de janeiro de 2025: impressions em insights de conta e de mídia, e plays, clips_replays_count e ig_reels_aggregated_all_plays_count na mídia, descontinuadas para a v22.0 e versões posteriores, no dia em que views chegou.
  • 21 de abril de 2025: essas quatro descontinuadas em todas as versões da API.

Em que deve se transformar cada métrica aposentada?

A Meta juntou views às aposentadorias de abril de 2025 na mesma entrada do changelog. Para as de janeiro, não indicou sucessora, então a coluna da direita mostra a métrica mais próxima que as referências de conta e de mídia da Meta documentavam em 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

A métrica impressions ainda retorna algum dado?

Só para mídias antigas. O changelog da Meta diz que requisições feitas após 21 de abril de 2025 para mídias criadas em ou após 2 de julho de 2024 retornam erro, e a referência de insights de mídia mantém impressions apenas para mídias criadas antes dessa data. Na conta, impressions está descontinuada em todas as versões, então código escrito hoje não tem uso para ela.

O que a métrica views conta?

Na conta, o número de vezes em que o conteúdo foi reproduzido ou exibido, em Reels, posts e Stories; em um único post, Reel ou Story, o número de vezes em que foi reproduzido no Instagram. impressions contava as vezes em que o conteúdo esteve na tela, anúncios incluídos, então um gráfico que passa de uma métrica para outra muda o que mede no momento da troca. A métrica views no nível da conta aceita apenas metric_type=total_value e se divide por media_product_type, e a Meta ainda a identifica como em desenvolvimento.

Quais métricas a Meta acrescentou desde então?

O changelog da Meta lista estas adições posteriores às aposentadorias de 2025:

  • 3 de dezembro de 2025: reels_skip_rate e reposts na mídia, reposts na conta, e crossposted_views e facebook_views para Reels com crosspost.
  • 22 de abril de 2026: total_likes, total_comments e total_views, agregadas entre superfícies e incluindo mídia impulsionada, que a referência da Meta oferece apenas com Facebook Login; facebook_views também estendida a posts e Stories.
  • 22 de junho de 2026: link_clicks em Stories, contando toques em links como figurinhas de link, que o changelog restringe ao Facebook Login.

O que precisa mudar no código?

Uma lista de métricas escrita antes de 2025 precisa destas mudanças para continuar funcionando:

  • Troque impressions, plays, clips_replays_count, ig_reels_aggregated_all_plays_count e video_views por views, tanto nas requisições de conta quanto nas de mídia.
  • Peça views no nível da conta com metric_type=total_value. Ela não tem time_series, então leia um total por intervalo onde impressions dava uma linha diária.
  • Peça crossposted_views e facebook_views apenas em mídia publicada com crosspost, em uma requisição própria: a referência da Meta diz que ambas dão erro quando a mídia não foi publicada com crosspost.
  • Deixe total_likes, total_comments e total_views fora de apps de Instagram Login, já 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, detalhado por contact_button_type.
  • Trate um erro em um nome de métrica como um sinal para atualizar a lista, não para repetir a requisição.

Como as descontinuações chegam às versões antigas da API?

Em duas etapas. Uma mudança se aplica primeiro a partir de uma nova versão da Graph API, v21.0 para video_views e v22.0 para impressions, e depois chega a todas as versões em uma data indicada na mesma entrada do changelog, cerca de três meses depois nos dois casos. Fixar uma versão antiga ganha no máximo alguns meses, e o changelog da Instagram Platform da Meta lista as duas datas de cada mudança.

Quais aposentadorias anteriores ainda afetam código antigo?

Duas de antes de 2025 aparecem em código que não é tocado há tempos:

  • 11 de dezembro de 2023: as métricas de carousel_album, taps_forward, taps_back, exits e engagement na mídia, 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 permanecem.

Erros comuns

  • Pedir impressions para um post publicado desde julho de 2024. A Meta retorna erro para essa mídia; peça views.
  • Pedir views da conta como time_series. A Meta a documenta apenas com total_value, então leia um total para cada intervalo que você precisar.
  • Pedir crossposted_views ou facebook_views para mídia que nunca teve crosspost. A referência da Meta diz que ambas dão erro nesse caso.
  • Esperar total_likes, total_comments ou total_views com Instagram Login. A Meta os oferece apenas com Facebook Login; curtidas, comentários e visualizações continuam disponíveis.
Fazendo isso com o EasyCoexistence

De US$ 9 a US$ 0.75 por número conectado por mês, caindo conforme você adiciona números, com os primeiros 3 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 phone_call_clicks e email_contacts na API do Instagram?

A Meta não indicou uma sucessora direta quando elas terminaram em todas as versões em 8 de janeiro de 2025. A métrica mais próxima que a referência de conta documenta hoje é profile_links_taps, detalhada por contact_button_type.

O que substituiu as reproduções dos 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 em 21 de abril de 2025, três meses depois de introduzir views.

Por que minha chamada de insights do Instagram começou a falhar?

Verifique primeiro a lista de métricas: impressions, plays, video_views e as antigas métricas de perfil foram aposentadas, e views da conta aceita apenas total_value. Repetir a mesma requisição devolve o mesmo erro.

A Meta aposentou alguma métrica do Instagram em 2026?

Nenhuma aparece no changelog 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 amplo e link_clicks em Stories.

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