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.
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 insights de conta e de mídia, e abriu os insights para apps de Instagram Login.
Quando video_views e seis séries temporais de conta, entre elas profile_views e website_clicks, perderam suporte em todas as versões.
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.
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_viewsna mídia e as séries temporais de contaemail_contacts,get_direction_clicks,phone_call_clicks,profile_views,text_message_clicksewebsite_clicks, retiradas primeiro na v21.0. - 21 de janeiro de 2025: impressions em insights de conta e de mídia, e plays,
clips_replays_counteig_reels_aggregated_all_plays_countna 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.
| 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 |
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_ratee reposts na mídia, reposts na conta, ecrossposted_viewsefacebook_viewspara Reels com crosspost. - 22 de abril de 2026:
total_likes,total_commentsetotal_views, agregadas entre superfícies e incluindo mídia impulsionada, que a referência da Meta oferece apenas com Facebook Login;facebook_viewstambém estendida a posts e Stories. - 22 de junho de 2026:
link_clicksem 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_countevideo_viewspor 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 temtime_series, então leia um total por intervalo onde impressions dava uma linha diária. - Peça
crossposted_viewsefacebook_viewsapenas 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_commentsetotal_viewsfora de apps de Instagram Login, já que a Meta as oferece apenas com Facebook Login. - Substitua
phone_call_clicks,email_contacts,text_message_clickseget_direction_clicksporprofile_links_taps, detalhado porcontact_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, 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_monthpermanecem.
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.
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