Insights de publicaciones de Facebook en la API: visualizaciones, alcance e interacción
Los insights de las publicaciones de Facebook se obtienen con GET /{page-post-id}/insights y métricas como post_media_view, las veces que se reprodujo o se mostró la publicación, post_total_media_view_unique, sus espectadores únicos, post_clicks y post_reactions_by_type_total. Meta dejó obsoleto post_impressions en noviembre de 2025 y post_impressions_unique en junio de 2026, así que las visualizaciones y los espectadores únicos ahora reemplazan a las impresiones y al alcance.
easyCoexistence lee los insights de publicaciones de Facebook con get_social_insights, para que Claude, ChatGPT o tu propio código puedan preguntar cómo le fue a una publicación y recibir de vuelta las visualizaciones, espectadores únicos, clics y reacciones vigentes de Meta, con list_social_posts para encontrar la publicación.
La alternativa recomendada por Meta a post_impressions_unique, cuya retirada en todas las versiones de la API fijó para junio de 2026.
Cuando post_impressions dejó de devolver datos en todas las versiones; Meta indica post_media_view como su alternativa.
El período que Meta indica para métricas de publicación como post_media_view, post_clicks y los totales de reacciones.
Lo que incluyen los conteos de me gusta de Meta: tanto las reacciones de me gusta como las de me importa.
Lo que devuelve Meta, en lugar de un error, cuando la app no tiene el permiso read_insights.
¿Qué métricas de publicación funcionan en 2026?
Estas están en la referencia de insights de Meta y fuera de sus listas de obsolescencia a 1 de noviembre de 2026. Cada una se lee con el ID de la publicación, con period lifetime salvo indicación contraria:
post_media_view: veces que se reprodujo o se mostró la publicación, con desglosesis_from_adseis_from_followers.post_total_media_view_unique: los espectadores únicos de la publicación, el reemplazo de alcance que propone Meta.post_clicks: clics en cualquier parte de la publicación que no generaron una historia;post_clicks_by_typelos separa por tipo de consumo.post_reactions_by_type_total: reacciones por tipo, más un total por cada tipo, comopost_reactions_love_totalopost_reactions_anger_total.post_video_views: reproducciones de un video de al menos 3 segundos, con period lifetime o day.
¿Qué reemplazó a las impresiones y al alcance de las publicaciones?
Meta pasó la medición de publicaciones de impresiones a visualizaciones de medios en dos etapas, cada una para todas las versiones de la API a la vez, y un nombre retirado ahora devuelve un error de métrica no válida. Su changelog, su página de métricas obsoletas y sus notas de la Graph API v25 dan estas alternativas:
| Deprecated | Use instead | |
|---|---|---|
| Nov 15, 2025 | post_impressions | post_media_view |
| Nov 15, 2025 | post_impressions_paid | post_media_view with is_from_ads |
| Nov 15, 2025 | post_impressions_fan | post_media_view with is_from_followers |
| June 2026 | post_impressions_unique | post_total_media_view_unique |
| June 2026 | post_impressions_paid_unique, post_impressions_organic_unique | post_media_view breakdowns, which count views rather than people |
¿Cuál es la diferencia entre visualizaciones y espectadores únicos?
Las visualizaciones cuentan reproducciones o apariciones; los espectadores únicos cuentan personas. post_media_view suma cada vez que se reprodujo o se mostró la publicación, así que una persona que la ve dos veces cuenta dos veces, mientras que post_total_media_view_unique cuenta a cada espectador único una vez. Meta marca las métricas que terminan en _unique como aproximadas y calcula los valores únicos de forma independiente, así que un total no tiene por qué igualar la suma de sus partes.
¿Cómo se piden las métricas de una publicación?
Con GET /{page-post-id}/insights y metric con una lista separada por comas, o GET /{page-post-id}/insights/{metric} para una sola. El token debe provenir de alguien que pueda realizar la tarea ANALYZE en la Página, con read_insights y pages_read_engagement concedidos, y cada resultado trae name, period, values, title y description. El ejemplo propio de Meta pide los totales de reacciones:
GET /{page-post-id}/insights?metric=post_reactions_like_total,post_reactions_love_total
{
"data": [
{
"name": "post_reactions_like_total",
"period": "lifetime",
"values": [{ "value": 226 }],
"title": "Lifetime Total Like Reactions of a post.",
"id": "{page-post-id}/insights/post_reactions_like_total/lifetime"
},
{
"name": "post_reactions_love_total",
"period": "lifetime",
"values": [{ "value": 17 }],
"title": "Lifetime Total Love Reactions of a post.",
"id": "{page-post-id}/insights/post_reactions_love_total/lifetime"
}
]
}¿Cómo se cuentan las reacciones, los comentarios y los compartidos?
Desde los propios campos de la publicación, junto a sus insights. fields=reactions.summary(total_count) devuelve el total de reacciones, y reactions.type(LOVE).limit(0).summary(total_count) el conteo de un tipo, entre LIKE, LOVE, WOW, HAHA, SORRY y ANGRY. El campo shares contiene el número de compartidos, que Meta dice que puede incluir publicaciones eliminadas y publicaciones que el token no puede ver, y el edge comments con summary=true agrega un total_count.
¿Cómo se relacionan las métricas de la publicación con las métricas de la Página?
Las métricas de Página suman el contenido de la Página en un período, mientras que las métricas de publicación dan los totales lifetime de una publicación. page_post_engagements cuenta la interacción con las publicaciones de la Página mediante reacciones, comentarios, compartidos y más, por day, week o days_28, y page_media_view y page_total_media_view_unique hacen lo mismo con visualizaciones y espectadores. Meta eliminó post_engaged_users en 2024, así que la interacción por publicación se construye a partir de clics, reacciones, comentarios y compartidos.
¿Qué tan actualizados están los datos y hasta qué fecha llegan?
La mayoría de las métricas se actualiza una vez al día, y las que Meta marca con asterisco, como post_clicks, varias veces al día. Meta conserva dos años de insights de las Páginas públicas, pero solo 5 días de las no publicadas. lifetime significa el período para el que hay datos disponibles, de dos años o menos por defecto. Los datos de insights de Página necesitan una Página con 100 o más me gusta, y varias métricas de video dan 0 en un video recompartido desde otra Página.
¿Cómo lee easyCoexistence los insights de publicaciones?
get_social_insights recibe las métricas y, para una sola publicación, su object_id, el ID de publicación que devuelve list_social_posts; sin object_id lee la Página. period y los parámetros extra como since y until pasan a Meta sin cambios, y una métrica retirada vuelve como el error de métrica no válida de Meta, para que la IA pueda cambiar a un nombre vigente.
Errores comunes
- Pedir post_impressions_unique. Meta lo retiró para todas las versiones de la API en junio de 2026; pide post_total_media_view_unique para contar espectadores únicos.
- Sumar espectadores únicos entre publicaciones. Cada publicación cuenta sus propios espectadores, de forma aproximada, así que una persona que vio dos publicaciones se cuenta dos veces.
- Leer insights de un video recompartido desde otra Página. Varias métricas de video devuelven 0 en recompartidos; solo la Página que creó el video obtiene valores exactos.
- Confiar en un cero de una respuesta vacía. Sin read_insights Meta devuelve un conjunto de datos vacío en lugar de un error, así que revisa primero el permiso.
De US$ 9 a US$ 0.75 por conexión al mes, bajando a medida que agregas conexiones, con los primeros 3 días gratis.
Preguntas frecuentes
¿Qué reemplazó al alcance de las publicaciones en Facebook?
post_total_media_view_unique, el conteo de espectadores únicos de una publicación, tras la retirada de post_impressions_unique por parte de Meta en junio de 2026.
¿Puedo ver quién reaccionó a una publicación de la Página?
No. Meta devuelve los conteos de reacciones por tipo, pero una Página o persona solo puede consultar su propia reacción; las demás quedan privadas.
¿Los conteos de me gusta incluyen las reacciones de me importa?
Sí. Los totales de me gusta de Meta cuentan tanto me gusta como me importa, tanto en insights como en el edge de reacciones.
¿Puedo leer insights de una publicación de otra Página?
No a través de los insights de Página: necesitan un token de alguien que pueda realizar la tarea ANALYZE en la Página que creó la publicación.
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