Iniciar sesiónEmpezar prueba gratis
easyCoexistence APIs oficiales

Métricas obsoletas de la API de Instagram: impresiones reemplazadas por visualizaciones

Meta reemplazó impresiones por visualizaciones en la API de estadísticas de Instagram. Introdujo views el 21 de enero de 2025 y dejó obsoletos impressions, plays, clips_replays_count e ig_reels_aggregated_all_plays_count en todas las versiones de la API el 21 de abril de 2025, después de que video_views y seis métricas de cuenta terminaran el 8 de enero. Cambios posteriores añadieron métricas, como reposts y reels_skip_rate en diciembre de 2025.

easyCoexistence lee las estadísticas de Instagram con get_social_insights, que pasa a Meta los nombres de métricas que indiques tal cual, views incluida, y devuelve los datos de Meta o su propio mensaje de error cuando un nombre está retirado, para que Claude, ChatGPT o tu propio código sigan un cambio de nombre el mismo día en que Meta lo haga.

21 Apr 2025

Cuándo se dejaron obsoletas impressions, plays, clips_replays_count e ig_reels_aggregated_all_plays_count en todas las versiones de la API.

21 Jan 2025

Cuándo Meta introdujo views para las estadísticas de cuenta y de contenido, y abrió las estadísticas a las apps con Instagram Login.

8 Jan 2025

Cuándo video_views y seis series temporales de cuenta, entre ellas profile_views y website_clicks, dejaron de tener soporte en todas las versiones.

2 Jul 2024

Los contenidos creados el 2 de julio de 2024 o después devuelven un error, no datos, cuando se pide impressions después del 21 de abril de 2025.

total_value

El único metric_type que admite la métrica views a nivel de cuenta; impressions también ofrecía una time_series diaria.

¿Qué métricas de Instagram retiró Meta en 2025?

Dos rondas, cada una anunciada con meses de antelación en el changelog de Meta y aplicada primero desde una nueva versión de la Graph API, y después a todas las versiones:

  • 8 de enero de 2025: video_views en contenidos y las series temporales de cuenta email_contacts, get_direction_clicks, phone_call_clicks, profile_views, text_message_clicks y website_clicks, eliminadas primero en la v21.0.
  • 21 de enero de 2025: impressions en las estadísticas de cuenta y de contenido, y plays, clips_replays_count e ig_reels_aggregated_all_plays_count en contenidos, marcadas como obsoletas desde la v22.0 en adelante, el mismo día en que llegó views.
  • 21 de abril de 2025: esas cuatro quedaron obsoletas en todas las versiones de la API.

¿En qué debe convertirse cada métrica retirada?

Meta asoció views con las retiradas de abril de 2025 en la misma entrada del changelog. Para las de enero no nombró sucesora, así que la columna de la derecha da la métrica más cercana que sus referencias de cuenta y de contenido documentaban a 31 de octubre 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

¿Todavía devuelve impressions algún dato?

Solo para contenidos antiguos. El changelog de Meta indica que las peticiones hechas después del 21 de abril de 2025 para contenidos creados el 2 de julio de 2024 o después devuelven un error, y su referencia de estadísticas de contenido mantiene impressions solo para contenidos creados antes de esa fecha. En la cuenta, impressions está obsoleta en todas las versiones, así que el código escrito hoy no tiene uso para ella.

¿Qué cuenta views?

En la cuenta, el número de veces que el contenido se reprodujo o se mostró, en Reels, publicaciones e historias; en una sola publicación, Reel o historia, el número de veces que se reprodujo en Instagram. impressions contaba las veces que el contenido apareció en pantalla, incluidos los anuncios, así que un gráfico que pasa de una a otra cambia lo que mide en el cambio. views a nivel de cuenta solo admite metric_type=total_value y se desglosa por media_product_type, y Meta todavía la etiqueta como en desarrollo.

¿Qué métricas ha añadido Meta desde entonces?

El changelog de Meta enumera estas adiciones posteriores a las retiradas de 2025:

  • 3 de diciembre de 2025: reels_skip_rate y reposts en contenidos, reposts en la cuenta, y crossposted_views y facebook_views para Reels publicados en varias plataformas.
  • 22 de abril de 2026: total_likes, total_comments y total_views, agregadas entre superficies e incluyendo contenido promocionado, que la referencia de Meta ofrece solo con Facebook Login; facebook_views también se extendió a publicaciones e historias.
  • 22 de junio de 2026: link_clicks en historias, que cuenta los toques en enlaces como los stickers de enlace, y que el changelog limita a Facebook Login.

¿Qué debe cambiar en el código?

Una lista de métricas escrita antes de 2025 necesita estos cambios para seguir funcionando:

  • Sustituye impressions, plays, clips_replays_count, ig_reels_aggregated_all_plays_count y video_views por views, tanto en las peticiones de cuenta como en las de contenido.
  • Pide views a nivel de cuenta con metric_type=total_value. No tiene time_series, así que lee un total por rango donde impressions daba una línea diaria.
  • Pide crossposted_views y facebook_views solo en contenido publicado en varias plataformas, en una petición propia: la referencia de Meta indica que ambas devuelven error si el contenido no se publicó así.
  • No incluyas total_likes, total_comments ni total_views en apps con Instagram Login, ya que Meta solo las ofrece con Facebook Login.
  • Sustituye phone_call_clicks, email_contacts, text_message_clicks y get_direction_clicks por profile_links_taps desglosado por contact_button_type.
  • Trata un error en un nombre de métrica como una señal para actualizar la lista, no para repetir la petición.

¿Cómo llegan las obsolescencias a las versiones antiguas de la API?

En dos pasos. Un cambio se aplica primero desde una nueva versión de la Graph API, v21.0 para video_views y v22.0 para impressions, y después llega a todas las versiones en una fecha indicada en la misma entrada del changelog, unos tres meses después en ambos casos. Fijar una versión anterior solo gana unos pocos meses como mucho, y el changelog de Instagram Platform de Meta enumera ambas fechas para cada cambio.

¿Qué retiradas anteriores a 2025 siguen afectando al código antiguo?

Dos de antes de 2025 aparecen en código que no se ha tocado desde entonces:

  • 11 de diciembre de 2023: las métricas de carousel_album taps_forward, taps_back, exits y engagement en contenido, y audience_gender_age, audience_locale, audience_country y audience_city en la cuenta, donde follower_demographics ahora cubre edad, ciudad, país y género.
  • 19 de agosto de 2024: los periodos last_14_days, last_30_days, last_90_days y prev_month para engaged_audience_demographics y reached_audience_demographics; this_week y this_month siguen vigentes.

Errores comunes

  • Pedir impressions de una publicación hecha desde julio de 2024. Meta devuelve un error para ese contenido; pide views.
  • Pedir views de cuenta como time_series. Meta lo documenta solo con total_value, así que lee un total para cada rango que necesites.
  • Pedir crossposted_views o facebook_views para contenido que nunca se publicó en varias plataformas. La referencia de Meta indica que ambas devuelven error en ese caso.
  • Esperar total_likes, total_comments o total_views con Instagram Login. Meta las ofrece solo con Facebook Login; likes, comments y views siguen disponibles.
Hacerlo con EasyCoexistence

Desde US$ 9 por número conectado al mes, bajando hasta US$ 0.75 a medida que sumas números, con los primeros 3 días gratis.

Preguntas frecuentes

¿Qué reemplazó a phone_call_clicks y email_contacts en la API de Instagram?

Meta no nombró una sucesora directa cuando terminaron en todas las versiones el 8 de enero de 2025. La métrica más cercana que su referencia de cuenta documenta hoy es profile_links_taps, desglosada por contact_button_type.

¿Qué reemplazó a plays en los Reels de Instagram?

views. Meta dejó obsoletos plays, clips_replays_count e ig_reels_aggregated_all_plays_count en todas las versiones de la API el 21 de abril de 2025, tres meses después de introducir views.

¿Por qué empezó a fallar mi llamada de estadísticas de Instagram?

Revisa antes la lista de métricas: impressions, plays, video_views y las antiguas métricas de perfil están retiradas, y views de cuenta solo admite total_value. Repetir la misma petición devuelve el mismo error.

¿Meta retiró alguna métrica de Instagram en 2026?

Ninguna aparece en el changelog de Instagram de Meta hasta el 28 de octubre de 2026. Sus entradas de 2026 añaden métricas en su lugar, entre ellas total_views, un facebook_views más amplio y link_clicks en historias.

Sigue leyendo

Conecta tu primer canal en dos minutos.

Sin esperar revisiones de las plataformas. Conecta WhatsApp, Instagram, TikTok u otro canal, pídele a tu IA que publique, responda o te haga un informe, y míralo trabajar.

  • 3 días gratis
  • Cancela cuando quieras
  • Solo APIs oficiales
  • Monitorizado 24/7

Verificado el