Iniciar sesiónEmpezar prueba gratis
easyCoexistence APIs oficiales

Insights de Reels de Instagram a través de la API

El endpoint de insights de medios de Instagram, GET /<IG_MEDIA_ID>/insights, devuelve estas métricas para un Reel: views, reach, likes, comments, shares, saved, reposts, total_interactions, ig_reels_avg_watch_time, ig_reels_video_view_total_time y reels_skip_rate, además de crossposted_views y facebook_views para un Reel con crossposting. plays, clips_replays_count e ig_reels_aggregated_all_plays_count se retiraron en abril de 2025, y en su lugar está views.

El get_social_insights de easyCoexistence recibe el media ID de un Reel y los nombres de las métricas, llama al endpoint de insights de Meta como la cuenta de Instagram conectada y devuelve los números de Meta o el error de la propia Meta.

3 seconds

Ventana que mide reels_skip_rate: la proporción de visualizaciones en las que se omitió el Reel dentro de sus primeros 3 segundos.

21 Apr 2025

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

3 Dec 2025

Cuándo se añadieron reels_skip_rate, reposts, crossposted_views y facebook_views a los insights de medios.

48 hours

Cuánto puede retrasarse la información en la que se basan las métricas de medios.

2 years

Cuánto tiempo guarda Meta las métricas de medios.

¿Qué métricas devuelve un Reel?

Las que la referencia de insights de medios de Meta enumera para media_product_type REELS, consultadas con GET /<IG_MEDIA_ID>/insights y un parámetro metric separado por comas. Meta marca varias como estimadas o en desarrollo, según se indica junto a cada una, y cuenta los likes y comentarios solo como actividad orgánica:

viewsTimes the Reel was played on Instagram. In development.
reachUnique accounts that saw the Reel at least once. Estimated.
likesLikes on the Reel, organic only.
commentsComments on the Reel, organic only.
sharesTimes the Reel was shared.
savedTimes the Reel was saved.
repostsReposts, minus reposts later deleted.
total_interactionsLikes, saves, comments and shares, minus unlikes, unsaves and deleted comments. In development.
ig_reels_avg_watch_timeAverage time spent playing the Reel.
ig_reels_video_view_total_timeTotal time the Reel was played, replays included. In development.
reels_skip_rateShare of initial views that skipped within the first 3 seconds. Estimated, in development.
crossposted_viewsPlays across Instagram and where the Reel was crossposted, combined. Throws if it was not crossposted.
facebook_viewsPlays of the crossposted Reel outside Instagram. Throws if it was not crossposted.

¿Qué devuelve una petición de insights de Reels?

Un objeto por métrica en data, cada uno con name, period, values, title, description e id. period siempre es lifetime: Meta lo fija para las métricas de medios y no puede cambiarse, así que la petición no necesita indicarlo. La referencia de Meta describe las dos métricas de tiempo de visualización como cantidades de tiempo sin especificar una unidad, así que compáralas con un Reel que conozcas antes de graficarlas.

A Reels insights request and the shape of its answer
GET https://graph.instagram.com/<IG_MEDIA_ID>/insights
  ?metric=views,reach,ig_reels_avg_watch_time,reels_skip_rate
  &access_token=<INSTAGRAM_USER_ACCESS_TOKEN>

{
  "data": [
    {
      "name": "views",
      "period": "lifetime",
      "values": [{ "value": <VALUE> }],
      "title": "<TITLE>",
      "description": "<DESCRIPTION>",
      "id": "<IG_MEDIA_ID>/insights/views/lifetime"
    }
  ]
}

¿Qué métricas de Reels se retiraron y qué las reemplazó?

Meta marcó como obsoletas las tres primeras desde Graph API v22.0 el 21 de enero de 2025, el día en que introdujo views, y en todas las versiones el 21 de abril de 2025; video_views quedó obsoleta desde v21.0 y en todas las versiones el 8 de enero de 2025. Una petición que nombra una métrica retirada falla, así que una lista de métricas escrita antes de 2025 necesita actualizarse:

RetiredRequest instead
playsDeprecated in every version on 21 Apr 2025views
clips_replays_countDeprecated in every version on 21 Apr 2025views
ig_reels_aggregated_all_plays_countDeprecated in every version on 21 Apr 2025views
video_viewsDeprecated in every version on 8 Jan 2025views
impressionsNot in Meta's Reels list; returns an error for media created on or after 2 Jul 2024views

¿Qué cuentan las visualizaciones y el alcance en un Reel?

views es el número de veces que se reprodujo el Reel en Instagram, una métrica que Meta marca como en desarrollo; reach es el número de cuentas únicas que lo vieron al menos una vez, que Meta marca como estimado. likes, comments, views y total_interactions cuentan solo actividad orgánica, sin incluir la interacción con anuncios creados a partir del Reel. total_likes, total_comments y total_views, que incluyen contenido promocionado, solo se ofrecen con Facebook Login.

¿Qué límites y retrasos aplican?

La referencia de insights de medios de Meta fija estas reglas para las cifras de un Reel:

  • Los datos detrás de las métricas pueden retrasarse hasta 48 horas.
  • Las métricas de medios se almacenan hasta 2 años.
  • Los datos faltantes o no disponibles devuelven un conjunto de datos vacío, no 0.
  • crossposted_views y facebook_views generan error en un Reel que no fue publicado en cruzado, así que pídelas en una llamada aparte.
  • Un desglose que una métrica solicitada no admite hace fallar toda la petición con An unknown error has occurred.
  • Con Instagram Login el token necesita instagram_business_basic e instagram_business_manage_insights, en graph.instagram.com.

¿Cómo lee get_social_insights un Reel?

Con el account_id de la conexión, el ID de medio del Reel como object_id y una lista de métricas. easyCoexistence llama a GET /<IG_MEDIA_ID>/insights en graph.instagram.com con el token de la cuenta, pasa a Meta los nombres de las métricas tal como se indican y devuelve los datos de Meta, o el error propio de Meta cuando un nombre está retirado. list_social_posts devuelve los IDs de medios de las publicaciones y Reels recientes de la cuenta.

get_social_insights arguments for one Reel
{
  "account_id": "<ACCOUNT_ID>",
  "object_id": "<REEL_MEDIA_ID>",
  "metrics": [
    "views", "reach", "likes", "comments", "shares", "saved",
    "total_interactions", "ig_reels_avg_watch_time",
    "ig_reels_video_view_total_time", "reels_skip_rate"
  ]
}

Errores comunes

  • Pedir plays o clips_replays_count. Ambas quedaron obsoletas en todas las versiones de la API el 21 de abril de 2025; pide views.
  • Incluir crossposted_views o facebook_views en una petición general. Generan error en un Reel que no fue publicado en cruzado, y el error hace fallar la llamada.
  • Suponer una unidad para el tiempo de visualización. La referencia de Meta no indica ninguna para ig_reels_avg_watch_time ni para ig_reels_video_view_total_time, así que compara con un Reel conocido.
  • Leer un resultado vacío como cero. Meta devuelve un conjunto de datos vacío cuando los datos no existen o no están disponibles en ese momento.
Hacerlo con EasyCoexistence

easyCoexistence lee los insights de un Reel con get_social_insights, para que Claude, ChatGPT o tu propio código puedan preguntar cómo le fue a un Reel y obtener visualizaciones, alcance, tiempo de visualización y tasa de omisión directamente de Meta para la cuenta conectada, con el error propio de Meta cuando un nombre de métrica está retirado. De US$ 9 a US$ 0.75 por conexión al mes, con precio decreciente al añadir conexiones, y los primeros 3 días gratis.

Preguntas frecuentes

¿Por qué una petición de insights de Reels devuelve un resultado vacío?

Meta devuelve un conjunto de datos vacío, no 0, cuando los datos no existen o no están disponibles en ese momento, y los datos detrás de las métricas pueden retrasarse hasta 48 horas.

¿Cómo obtengo el tiempo de visualización de Reels desde la API?

Pide ig_reels_avg_watch_time para el promedio e ig_reels_video_view_total_time para el total, incluidas las repeticiones, desde GET /<IG_MEDIA_ID>/insights.

¿Qué es reels_skip_rate?

El porcentaje de visualizaciones iniciales en las que se omitió el Reel dentro de sus primeros 3 segundos. Meta lo añadió el 3 de diciembre de 2025 y lo marca como estimado y en desarrollo.

¿Los insights de Reels incluyen visualizaciones de anuncios?

No. likes, comments, views y total_interactions cuentan solo actividad orgánica; total_views, que incluye contenido promocionado, solo se ofrece con Facebook Login.

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