Iniciar sesiónEmpezar prueba gratis
easyCoexistence APIs oficiales

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.

post_total_media_view_unique

La alternativa recomendada por Meta a post_impressions_unique, cuya retirada en todas las versiones de la API fijó para junio de 2026.

15 Nov 2025

Cuando post_impressions dejó de devolver datos en todas las versiones; Meta indica post_media_view como su alternativa.

lifetime

El período que Meta indica para métricas de publicación como post_media_view, post_clicks y los totales de reacciones.

Like + care

Lo que incluyen los conteos de me gusta de Meta: tanto las reacciones de me gusta como las de me importa.

Empty dataset

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 desgloses is_from_ads e is_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_type los separa por tipo de consumo.
  • post_reactions_by_type_total: reacciones por tipo, más un total por cada tipo, como post_reactions_love_total o post_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:

DeprecatedUse instead
Nov 15, 2025post_impressionspost_media_view
Nov 15, 2025post_impressions_paidpost_media_view with is_from_ads
Nov 15, 2025post_impressions_fanpost_media_view with is_from_followers
June 2026post_impressions_uniquepost_total_media_view_unique
June 2026post_impressions_paid_unique, post_impressions_organic_uniquepost_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:

Meta's example request and response for one post, trimmed
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.
Hacerlo con EasyCoexistence

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