API Graph versión

Se actualizó este documento.
La traducción en español no está disponible todavía.

Actualización del documento en inglés: 11 de sep.
Actualización del documento en español: 26 oct. 2018

Page Insights

Represents insights for Facebook Pages and Page posts. Refer to our Pages API documentation.

On March 14, 2024, a number of the Page Insights metrics were deprecated for all API versions. The API returns an invalid metric error when calling any of these metrics. Read our blog to learn more.

Lectura

Get metrics for Pages or Page posts.

Nueva experiencia para las páginas

This endpoint is supported for Nueva experiencia para las páginas.

Limitations

Page Insights data is only available on Pages with 100 or more likes.
Most metrics will update once every 24 hours.
Only the last two years of insights data is available.
The values for period are calculated from the initial collection of the data point.
"Period" in the tables below only refers to the time frame for which the metric can be accessed in an aggregated form.
The value "lifetime" means the time period for which the insights data is available. By default, this time period is 2 years or shorter.
Only 90 days of insights can be viewed at one time when using the since and until parameters.
When using since and until, the since date data will be included in the first value returned.
Unique impression insights values are calculated independently.
- Total page reach may not always be exactly equal to the sum of paid and non-paid unique values.
- Total page reach may not always be exactly equal to the sum of viral_unique and organic_unique.
When an organic post is boosted, metrics for paid post impressions will include both organic and paid reach.
Demographic metrics, such as age, gender, and location, are only returned if there is data for 100 or more people.
Breakdown metrics for Page post and Page view insights will only return non-zero values.
Several video related metrics only return accurate values if the person requesting the metric is the Page video post creator.
If you reshare a video post of another Page and retrieve its insights, the metrics return a value of 0. Metrics that return 0 for resharers are denoted with "Returns 0 for reshared videos" in their description.
If you neglect to indicate a specific metric or metrics for the endpoint, you will receive an error response with code 3001, with subcode 1504028 and an error message that states: "No metric was specified to be fetched. Please specify one or more metrics to be fetched and try again."
Interactions on Reels are not included.

Requirements

Type	Description
Access Tokens	A Page access token requested by a person who can perform the ANALYZE task on the Page.
Features	Not applicable.
Permissions	`read_insights`, `pages_read_engagement`
Page Tasks	ANALYZE

Example

Single Metric Sample Request

Graph API Explorer

GET v21.0/{object-id}/insights/{metric} HTTP/1.1
Host: graph.facebook.com

/* PHP SDK v5.0.0 */
/* make the API call */
try {
  // Returns a `Facebook\FacebookResponse` object
  $response = $fb->get(
    '{object-id}/insights/{metric}',
    '{access-token}'
  );
} catch(Facebook\Exceptions\FacebookResponseException $e) {
  echo 'Graph returned an error: ' . $e->getMessage();
  exit;
} catch(Facebook\Exceptions\FacebookSDKException $e) {
  echo 'Facebook SDK returned an error: ' . $e->getMessage();
  exit;
}
$graphNode = $response->getGraphNode();
/* handle the result */

/* make the API call */
FB.api(
    "{object-id}/insights/{metric}",
    function (response) {
      if (response && !response.error) {
        /* handle the result */
      }
    }
);

/* make the API call */
new GraphRequest(
    AccessToken.getCurrentAccessToken(),
    "{object-id}/insights/{metric}",
    null,
    HttpMethod.GET,
    new GraphRequest.Callback() {
        public void onCompleted(GraphResponse response) {
            /* handle the result */
        }
    }
).executeAsync();

/* make the API call */
FBSDKGraphRequest *request = [[FBSDKGraphRequest alloc]
                               initWithGraphPath:@"{object-id}/insights/{metric}"
                                      parameters:params
                                      HTTPMethod:@"GET"];
[request startWithCompletionHandler:^(FBSDKGraphRequestConnection *connection,
                                      id result,
                                      NSError *error) {
    // Handle the result
}];

Si quieres obtener información sobre cómo usar la API Graph, lee nuestra guía de uso de la API Graph.

Multiple Metric Sample Request

NOTE: If your request times out or some metrics are not returned, try reducing the number of metrics in your API request.

Graph API Explorer

GET v21.0/{object-id}/insights?metric={metric-1},{metric-2},{metric-3},... HTTP/1.1
Host: graph.facebook.com

/* PHP SDK v5.0.0 */
/* make the API call */
try {
  // Returns a `Facebook\FacebookResponse` object
  $response = $fb->get(
    '{object-id}/insights?metric={metric-1},{metric-2},{metric-3},...',
    '{access-token}'
  );
} catch(Facebook\Exceptions\FacebookResponseException $e) {
  echo 'Graph returned an error: ' . $e->getMessage();
  exit;
} catch(Facebook\Exceptions\FacebookSDKException $e) {
  echo 'Facebook SDK returned an error: ' . $e->getMessage();
  exit;
}
$graphNode = $response->getGraphNode();
/* handle the result */

/* make the API call */
FB.api(
    "{object-id}/insights?metric={metric-1},{metric-2},{metric-3},...",
    function (response) {
      if (response && !response.error) {
        /* handle the result */
      }
    }
);

/* make the API call */
new GraphRequest(
    AccessToken.getCurrentAccessToken(),
    "{object-id}/insights?metric={metric-1},{metric-2},{metric-3},...",
    null,
    HttpMethod.GET,
    new GraphRequest.Callback() {
        public void onCompleted(GraphResponse response) {
            /* handle the result */
        }
    }
).executeAsync();

/* make the API call */
FBSDKGraphRequest *request = [[FBSDKGraphRequest alloc]
                               initWithGraphPath:@"{object-id}/insights?metric={metric-1},{metric-2},{metric-3},..."
                                      parameters:params
                                      HTTPMethod:@"GET"];
[request startWithCompletionHandler:^(FBSDKGraphRequestConnection *connection,
                                      id result,
                                      NSError *error) {
    // Handle the result
}];

Si quieres obtener información sobre cómo usar la API Graph, lee nuestra guía de uso de la API Graph.

Metrics

Metric names indicate whether a metric is for a Page or a Page post.

Suffix	Description
`_unique`	Indicates that the metric shows the number of unique users who performed a specific action, for example `page_impressions_unique`. Metrics generated with the `_unique` suffix are approximate and may not be 100% accurate.
`_login`	Indicates whether a person was logged into Facebook, for example, `page_tab_views_login_top`.
`_logout`	Indicates whether a person is logged out of Facebook, for example `page_views_logout`.
`_source`	Indicates that the metric will be broken down into a list of referral sources, for example `page_fans_by_like_source`. External referrals are broken down by domain. Internal referrals are broken down by Facebook-specific features such as Profile, Search, Requests, Suggestions, Stream, etc. In these cases the `value` returned will be an object containing a series of key-value pairs where the key is the source name and the value is the metric for that source.
`*`	Indicates that a metric is refreshed several times during the day, for example `page_impressions_unique*`.

Page Content

Most of the metrics below can be retrieved using post_activity_by_action_type, post_clicks_by_type, and page_consumptions_by_consumption_type.

Metric Name	Description	Values for `period`
`page_tab_views_login_top_unique`	Número de usuarios que iniciaron sesión en Facebook y vieron las pestañas de tu página. (See possible types)	day, week
`page_tab_views_login_top`	Número de veces que los usuarios que iniciaron sesión en Facebook vieron las pestañas de tu página. (See possible types)	day, week
`page_tab_views_logout_top`	Número de veces que usuarios que no iniciaron sesión en Facebook vieron pestañas de tu página. (See possible types)	day

Tab Types

Tab types for Page content metrics.

Name	Description
`allactivity`	Administrative tab
`app`	Custom created tab
`info`	About tab view
`insights`	Insights tab
`likes`	Likes tab
`locations`	Map tab
`photos`	Photos tab
`photos_albums`	Photos tab
`photos_stream`	Photos tab
`profile`	Pages timeline
`profile_info`	Info tab
`profile_likes`	Likes tab
`profile_photos`	Photos tab
`timeline`	Pages timeline
`events`	Events tab
`videos`	Videos tab
`wall`	Timeline

Page CTA Clicks

Metric Name	Description	Values for `period`
`page_total_actions`	Número de clics en la información de contacto de tu página y el botón de llamada a la acción.	day, week, days_28

Page Engagement

The "like" reaction counts include both "like" and "care" reactions.

Metric Name	Description	Values for `period`
`page_post_engagements*`	Número de veces que las personas interactuaron con tus publicaciones por medio de reacciones, comentarios, contenido compartido, etc.	day, week, days_28
`page_fan_adds_by_paid_non_paid_unique`	Número de cuentas del centro de cuentas que indicaron que les gusta tu página por primera vez, desglosadas en función de si el Me gusta fue resultado del contenido pagado o del contenido orgánico. Esta métrica es una estimación.	day
`page_lifetime_engaged_followers_unique*`	Alguien que sigue tu página y que, en los últimos 14 días, haya visto uno o más de tus videos en vivo o grabados anteriormente durante al menos un minuto o haya interactuado con su contenido como mínimo una vez, ya sea través de un comentario, contenido compartido, una reacción o un Me gusta.
`page_daily_follows*`	Número de veces que se empezó a seguir tu página o perfil de Facebook en el período seleccionado.	day
`page_daily_follows_unique*`	Número de cuentas del centro de cuentas que empezaron a seguir tu página en el período seleccionado. Esta métrica es una estimación.	day, week, days_28
`page_daily_unfollows_unique*`	Número de cuentas del centro de cuentas que dejaron de seguir tu página en el período seleccionado. Esta métrica es una estimación.	day, week, days_28
`page_follows*`	Número de seguidores de tu página o perfil de Facebook. Se calcula como el número de seguidores menos el número de personas que dejaron de seguirte desde que se creó la página o el perfil de Facebook.	day

Page Impressions

Metric Name	Description	Values for `period`
`page_impressions*`	Número de veces que se mostró en la pantalla de una persona contenido de tu página o relacionado con esta. Incluye publicaciones, historias, anuncios y otros contenidos o información de tu página.	day, week, days_28
`page_impressions_unique*`	Número de personas a las que se mostró en pantalla contenido de tu página o relacionado con ella. Incluye publicaciones, visitas, anuncios, información social de personas que interactúan con tu página y más. Esta métrica es una estimación.	day, week, days_28
`page_impressions_paid*`	Número de veces que se mostró en la pantalla de una persona contenido de publicaciones o historias de tu página o relacionado con ella a través de distribución pagada, como un anuncio.	day, week, days_28
`page_impressions_paid_unique*`	Número de cuentas del centro de cuentas que vieron tus anuncios al menos una vez. El alcance es diferente de las impresiones, que pueden incluir varias visualizaciones de tus anuncios por parte de las mismas cuentas del centro de cuentas. Esta métrica es una estimación.	day, week, days_28
`page_impressions_viral*`	Número de veces que se mostró en la pantalla de una persona contenido de tu página o relacionado con esta con información social asociada. Se muestra información social cuando el amigo de una persona interactúa con tu página, publicación o historia, por ejemplo, indica que le gusta tu página o la sigue, interactúa con una publicación, comparte una foto de tu página o registra una visita en ella. Esta métrica está en desarrollo.	day, week, days_28
`page_impressions_viral_unique*`	Esta métrica calcula el alcance de la distribución orgánica o pagada de tu página de Facebook y su contenido cuando se mostraron con información social asociada. La información social se muestra en el feed después de que alguien interactúa con tu página, publicación o historia. El alcance solo se cuenta una vez si se produce tanto de la distribución orgánica como de la distribución pagada. Esta métrica es una estimación y está en desarrollo.	day, week, days_28
`page_impressions_nonviral*`	Número de veces que tu página de Facebook y su contenido se mostraron en pantalla. No se incluyen las veces que se mostraron con información social asociada. La información social se muestra en el feed después de que alguien interactúa con tu página, publicación o historia. Esta métrica está en desarrollo.	day, week, days_28
`page_impressions_nonviral_unique*`	Esta métrica calcula el alcance de la distribución orgánica o pagada de tu página de Facebook y su contenido. No se incluyen las veces que se mostraron con interacción social asociada. La información social se muestra en el feed después de que alguien interactúa con tu página, publicación o historia. El alcance solo se cuenta una vez si se produce tanto de la distribución orgánica como de la distribución pagada. Esta métrica es una estimación y está en desarrollo.	day, week, days_28

Page Posts

Metric Name	Description	Values for `period`
`page_posts_impressions*`	Número de veces que se mostraron en la pantalla de una persona las publicaciones de tu página, incluidos estados, fotos, enlaces, videos y más.	day, week, days_28
`page_posts_impressions_unique*`	Número de personas a las que se mostró en pantalla alguna publicación de tu página, incluidos estados, fotos, enlaces, videos y más.	day, week, days_28
`page_posts_impressions_paid*`	Número de veces que tu página de Facebook y su contenido se mostraron en pantalla como resultado de tus anuncios.	day, week, days_28
`page_posts_impressions_paid_unique*`	Número de cuentas del centro de cuentas que vieron alguna de las publicaciones de tu página al menos una vez, como resultado de tus anuncios.	day, week, days_28
`page_posts_impressions_organic_unique*`	Número de personas a las que se mostró en pantalla alguna publicación de tu página a través de distribución no pagada.	day, week, days_28
`page_posts_served_impressions_organic_unique`	Número de personas a las que se entregaron las publicaciones de tu página en el feed, independientemente de si se mostraron en pantalla o no. Las publicaciones incluyen estados, fotos, enlaces, videos y más.	day, week, days_28
`page_posts_impressions_viral*`	Número de veces que se mostraron en la pantalla de una persona las publicaciones de tu página con información social asociada. Se muestra información social cuando el amigo de una persona interactúa con tu página o publicación, por ejemplo, indica que le gusta tu página o la sigue, interactúa con una publicación, comparte una foto de tu página o registra una visita en ella.	day, week, days_28
`page_posts_impressions_viral_unique*`	Número de personas a las que se mostró en pantalla alguna publicación de tu página con información social asociada. Como forma de distribución orgánica, se muestra información social cuando el amigo de una persona interactúa con tu página o publicación, por ejemplo, indica que le gusta tu página o la sigue, interactúa con una publicación, comparte una foto de tu página o registra una visita en ella.	day, week, days_28
`page_posts_impressions_nonviral*`	Número de veces que se mostraron en la pantalla de una persona las publicaciones de tu página. No incluye contenido creado sobre tu página con información social asociada. Se muestra información social cuando el amigo de una persona interactúa con tu página o publicación, por ejemplo, indica que le gusta tu página o la sigue, interactúa con una publicación, comparte una foto de tu página o registra una visita en ella.	day, week, days_28
`page_posts_impressions_nonviral_unique*`	Número de personas a las que se mostró en pantalla alguna publicación de tu página. No incluye contenido creado sobre tu página con información social asociada. Como forma de distribución orgánica, se muestra información social cuando el amigo de una persona interactúa con tu página o publicación, por ejemplo, indica que le gusta tu página o la sigue, interactúa con una publicación, comparte una foto de tu página o registra una visita en ella.	day, week, days_28

Page Post Engagement

Metric Name	Description	Values for `period`
`post_clicks*`	Número de personas que hicieron clic en cualquier lugar de tus publicaciones sin generar una historia.	lifetime
`post_clicks_by_type*`	Número de veces que las personas hicieron clic en cualquier lugar de tus publicaciones sin generar una historia, por tipo de consumo.	lifetime

Negative Feedback Types

Negative feedback types for page_negative_feedback_by_type metrics.

Name	Description
`hide_clicks`	Hide this story
`hide_all_clicks`	Hide all posts from this page
`report_spam_clicks`	Report an object as a spam
`unlike_page_clicks`	Unlike a page

Page Post Impressions

Metric Name	Description	Values for `period`
`post_impressions*`	Número de veces que se mostró en la pantalla de una persona la publicación de tu página. Las publicaciones incluyen estados, fotos, enlaces, videos y más.	lifetime
`post_impressions_unique*`	Número de personas a las que se mostró en pantalla la publicación de tu página. Las publicaciones incluyen estados, fotos, enlaces, videos y más. Esta métrica es una estimación.	lifetime
`post_impressions_paid*`	Número de veces que el contenido de tu página se mostró en pantalla como resultado de tus anuncios.	lifetime
`post_impressions_paid_unique*`	Número de cuentas del centro de cuentas que vieron tu publicación al menos una vez, como resultado de tus anuncios. Esta métrica es una estimación.	lifetime
`post_impressions_fan*`	Número de veces que el contenido de tu página se mostró en pantalla para cuentas que empezaron a seguir tu página o indicaron que les gusta.	lifetime
`post_impressions_fan_unique*`	Número de cuentas del centro de cuentas que empezaron a seguir tu página o indicaron que les gusta. Esta métrica es una estimación.	lifetime
`post_impressions_organic*`	Número de veces que tu publicación se mostró en pantalla a través de distribución orgánica.	lifetime
`post_impressions_organic_unique*`	Con esta métrica, se calcula el alcance de la distribución orgánica de tu contenido de Facebook, lo que incluye publicaciones, historias y anuncios. El alcance del contenido compartido se contabiliza solo para el contenido orgánico, que incluye casos en los que el contenido se comparte como una historia o en los que se vuelve a compartir. Esta métrica es una estimación.	lifetime
`post_impressions_viral*`	Número de veces que el contenido de tu página se mostró en pantalla con información social asociada. La información social se muestra en el feed después de que alguien interactúa con tu página, publicación o historia. Esta métrica está en desarrollo.	lifetime
`post_impressions_viral_unique*`	Esta métrica calcula el alcance cuando tu contenido de Facebook se vuelve a publicar o se comparte como historia. El alcance del contenido compartido se contabiliza solo para la distribución orgánica. Esta métrica es una estimación y está en desarrollo.	lifetime
`post_impressions_nonviral*`	Número de veces que el contenido de tu página se mostró en pantalla. No se incluyen las veces que tu contenido se mostró con información social asociada. La información social se muestra en el feed después de que alguien interactúa con tu página, publicación o historia. Esta métrica está en desarrollo.	lifetime
`post_impressions_nonviral_unique*`	Esta métrica calcula el alcance de la distribución orgánica o pagada del contenido de tu página. No se incluyen las veces que tu contenido se mostró con información social asociada. La información social se muestra en el feed después de que alguien interactúa con tu página, publicación o historia. El alcance solo se cuenta una vez si se produce tanto de la distribución orgánica como de la distribución pagada. Esta métrica es una estimación y está en desarrollo.	lifetime

Page Post Reactions

The "like" reaction counts include both "like" and "care" reactions.

Metric Name	Description	Values for `period`
`post_reactions_like_total`	Número total de reacciones "Me gusta" de una publicación.	lifetime
`post_reactions_love_total`	Número total de reacciones "Me encanta" de una publicación.	lifetime
`post_reactions_wow_total`	Número total de reacciones "Me asombra" de una publicación.	lifetime
`post_reactions_haha_total`	Número total de reacciones "Me divierte" de una publicación.	lifetime
`post_reactions_sorry_total`	Número total de reacciones "Me entristece" de una publicación.	lifetime
`post_reactions_anger_total`	Número total de reacciones "Me enoja" de una publicación.	lifetime
`post_reactions_by_type_total`	Número total de reacciones a la publicación por tipo.	lifetime

Page Reactions

The "like" reaction counts include both "like" and "care" reactions.

Metric Name	Description	Values for `period`
`page_actions_post_reactions_like_total*`	Total de reacciones "Me gusta" diarias en las publicaciones de una página.	day, week, days_28
`page_actions_post_reactions_love_total*`	Total de reacciones "Me encanta" diarias en las publicaciones de una página.	day, week, days_28
`page_actions_post_reactions_wow_total*`	Total de reacciones "Me asombra" diarias en las publicaciones de una página.	day, week, days_28
`page_actions_post_reactions_haha_total*`	Total de reacciones "Me divierte" diarias en las publicaciones de una página.	day, week, days_28
`page_actions_post_reactions_sorry_total*`	Total de reacciones "Me entristece" diarias en las publicaciones de una página.	day, week, days_28
`page_actions_post_reactions_anger_total*`	Total de reacciones "Me enoja" diarias en las publicaciones de una página.	day, week, days_28
`page_actions_post_reactions_total`	Total de reacciones diarias a las publicaciones de una página por tipo.	day

Page User Demographics

Metric Name	Description	Values for `period`
`page_fans`	Número total de personas que indicaron que les gusta tu página.	day
`page_fans_locale`	Datos de idioma totales de las personas a las que les gusta tu página según la configuración de idioma predeterminado que seleccionaron al acceder a Facebook.	day
`page_fans_city`	Datos de ubicación de Facebook totales, clasificados por ciudad, sobre las personas a las que les gusta tu página.	day
`page_fans_country`	Número de personas, por países, a las que les gusta tu página. Solo se incluyen los 45 países en los que haya más personas a las que les guste tu página.	day
`page_fan_adds`	Número de personas nuevas que indicaron que les gusta tu página.	day
`page_fan_adds_unique`	Número de cuentas del centro de cuentas que indicaron que les gusta tu página por primera vez. Esta métrica es una estimación.	day, week, days_28
`page_fan_removes`	"Ya no me gusta" de tu página.	day
`page_fan_removes_unique*`	"Ya no me gusta" de tu página.	day, week, days_28

Page Like Sources

Source types for page_fans_by_like_source and page_fans_by_like_source_unique metrics.

Name	Description
`Ads`	Page likes that came from people who saw your Page or post in an ad.
`News Feed`	Page likes that came from people who saw content posted by your Page or about your Page in News Feed.
`Page Suggestions`	Page likes that came from people saw your Page in a list of suggested Pages.
`Restored Likes from Reactivated Accounts`	Page likes that came from people who reactivated their Facebook profile.
`Search`	Page likes that came from people who saw you Page or post in search.
`Your Page`	Page likes that came from people who visited your Page.

Page Video Views

Metric Name	Description	Values for `period`
`page_video_views`	Número de veces que se reprodujeron los videos de tu página durante al menos 3 segundos, o casi en su totalidad si duran menos de 3 segundos. En una única instancia de reproducción de video, se excluirá el tiempo de las reproducciones repetidas.	day, week, days_28
`page_video_views_by_uploaded_hosted*`	Reproducciones de video diarias en el nivel de la página, desglosadas por todas las variantes de videos subidos a la página y videos alojados en la página.	day, week, days_28
`page_video_views_paid`	Número de veces que se reprodujeron los videos promocionados de tu página durante al menos 3 segundos, o casi en su totalidad si duran menos de 3 segundos. Para cada impresión de un video, se contarán las reproducciones por separado y se excluirá el tiempo de las reproducciones repetidas.	day, week, days_28
`page_video_views_organic`	Número de veces que se reprodujeron los videos de tu página durante al menos 3 segundos, o casi en su totalidad si duran menos de 3 segundos, mediante alcance orgánico. En una única instancia de reproducción de video, se excluirá el tiempo de las reproducciones repetidas.	day, week, days_28
`page_video_views_by_paid_non_paid*`	Número de veces que se reprodujeron los videos de tu página durante al menos 3 segundos, o casi en su totalidad si duran menos de 3 segundos, desglosado por totales, pagadas y no pagadas. En una única instancia de reproducción de video, se excluirá el tiempo de las reproducciones repetidas.	day, week, days_28
`page_video_views_autoplayed`	Número de veces que se reprodujeron los videos de tu página automáticamente durante al menos 3 segundos, o casi en su totalidad si duran menos de 3 segundos. En una única instancia de reproducción de video, se excluirá el tiempo de las reproducciones repetidas.	day, week, days_28
`page_video_views_click_to_play`	Número de veces que se reprodujeron los videos de tu página durante al menos 3 segundos, o casi en su totalidad si duran menos de 3 segundos, después de que las personas hicieron clic para reproducirlos. En una única instancia de reproducción de video, se excluirá el tiempo de las reproducciones repetidas.	day, week, days_28
`page_video_views_unique`	Número de personas que vieron los videos de tu página durante al menos 3 segundos, o casi en su totalidad si duran menos de 3 segundos. En una única instancia de reproducción de video, se excluirá el tiempo de las reproducciones repetidas.	day, week, days_28
`page_video_repeat_views`	Número de veces que se volvieron a reproducir los videos de tu página durante al menos 3 segundos, o casi en su totalidad si duran menos de 3 segundos.	day, week, days_28
`page_video_complete_views_30s`	Número de veces que se reprodujeron los videos de tu página durante al menos 30 segundos, o casi en su totalidad si duran menos de 30 segundos. En una única instancia de reproducción de video, se excluirá el tiempo de las reproducciones repetidas.	day, week, days_28
`page_video_complete_views_30s_paid`	Número de veces que se reprodujeron los videos promocionados de tu página durante al menos 30 segundos, o casi en su totalidad si duran menos de 30 segundos. Para cada impresión de un video, se contarán las reproducciones por separado y se excluirá el tiempo de las reproducciones repetidas.	day, week, days_28
`page_video_complete_views_30s_organic`	Número de veces que se reprodujeron los videos de tu página durante al menos 30 segundos, o casi en su totalidad si duran menos de 30 segundos, mediante alcance orgánico. En una única instancia de reproducción de video, se excluirá el tiempo de las reproducciones repetidas.	day, week, days_28
`page_video_complete_views_30s_autoplayed`	Número de veces que se reprodujeron los videos de tu página automáticamente durante al menos 30 segundos, o casi en su totalidad si duran menos de 30 segundos. En una única instancia de reproducción de video, se excluirá el tiempo de las reproducciones repetidas.	day, week, days_28
`page_video_complete_views_30s_click_to_play`	Número de veces que se reprodujeron los videos de tu página durante al menos 30 segundos, o casi en su totalidad si duran menos de 30 segundos, después de que las personas hicieron clic para reproducirlos. En una única instancia de reproducción de video, se excluirá el tiempo de las reproducciones repetidas.	day, week, days_28
`page_video_complete_views_30s_unique`	Número de personas que reprodujeron los videos de tu página durante al menos 30 segundos, o casi en su totalidad si duran menos de 30 segundos. En una única instancia de reproducción de video, se excluirá el tiempo de las reproducciones repetidas.	day, week, days_28
`page_video_complete_views_30s_repeat_views`	Número de veces que se volvieron a reproducir los videos de tu página durante al menos 30 segundos, o casi en su totalidad si duran menos de 30 segundos.	day, week, days_28
`post_video_complete_views_30s_autoplayed`	Número de veces que se reprodujeron tus videos automáticamente durante al menos 30 segundos, o casi en su totalidad si duran menos de 30 segundos. En una única instancia de reproducción de video, se excluirá el tiempo de las reproducciones repetidas. Devuelve 0 para los videos compartidos.	lifetime
`post_video_complete_views_30s_clicked_to_play`	Número de veces que se reprodujeron tus videos durante al menos 30 segundos, o casi en su totalidad si duran menos de 30 segundos, después de que las personas hicieron clic para reproducirlos. En una única instancia de reproducción de video, se excluirá el tiempo de las reproducciones repetidas. Devuelve 0 para los videos compartidos.	lifetime
`post_video_complete_views_30s_organic`	Número de veces que se reprodujeron tus videos durante al menos 30 segundos, o casi en su totalidad si duran menos de 30 segundos, mediante alcance orgánico. En una única instancia de reproducción de video, se excluirá el tiempo de las reproducciones repetidas. Devuelve 0 para los videos compartidos.	lifetime
`post_video_complete_views_30s_paid`	Número de veces que se reprodujeron tus videos promocionados durante al menos 30 segundos, o casi en su totalidad si duran menos de 30 segundos. Para cada impresión de un video, se contarán las reproducciones por separado y se excluirá el tiempo de las reproducciones repetidas. Devuelve 0 para los videos compartidos.	lifetime
`post_video_complete_views_30s_unique`	Número de personas que vieron tus videos durante al menos 30 segundos, o casi en su totalidad si duran menos de 30 segundos. En una única instancia de reproducción de video, se excluirá el tiempo de las reproducciones repetidas.	lifetime
`page_video_views_10s`	Obsoleto a partir de Graph API v18: número de veces que se reprodujeron los videos de tu página durante al menos 10 segundos, o casi en su totalidad si duran menos de 10 segundos. En una única instancia de reproducción de video, se excluirá el tiempo de las reproducciones repetidas.	day, week, days_28
`page_video_views_10s_paid`	Obsoleto a partir de Graph API v18: número de veces que se reprodujeron los videos promocionados de tu página durante al menos 10 segundos, o casi en su totalidad si duran menos de 10 segundos. Para cada impresión de un video, se contarán las reproducciones por separado y se excluirá el tiempo de las reproducciones repetidas.	day, week, days_28
`page_video_views_10s_organic`	Obsoleto a partir de Graph API v18: número de veces que se reprodujeron los videos de tu página durante al menos 10 segundos, o casi en su totalidad si duran menos de 10 segundos, por alcance orgánico. En una única instancia de reproducción de video, se excluirá el tiempo de las reproducciones repetidas.	day, week, days_28
`page_video_views_10s_autoplayed`	Obsoleto a partir de Graph API v18: número de veces que se reprodujeron automáticamente los videos de tu página durante al menos 10 segundos, o casi en su totalidad si duran menos de 10 segundos. En una única instancia de reproducción de video, se excluirá el tiempo de las reproducciones repetidas.	day, week, days_28
`page_video_views_10s_click_to_play`	Obsoleto a partir de Graph API v18: número de veces que se reprodujeron los videos de tu página durante al menos 10 segundos, o casi en su totalidad si duran menos de 10 segundos, después de que las personas hicieron clic para reproducirlos. En una única instancia de reproducción de video, se excluirá el tiempo de las reproducciones repetidas.	day, week, days_28
`page_video_views_10s_unique`	Obsoleto a partir de Graph API v18: número de personas que vieron los videos de tu página durante al menos 10 segundos, o casi en su totalidad si duran menos de 10 segundos. En una única instancia de reproducción de video, se excluirá el tiempo de las reproducciones repetidas.	day, week, days_28
`page_video_views_10s_repeat`	Obsoleto a partir de Graph API v18: número de veces que se volvieron a reproducir los videos de tu página durante al menos 10 segundos, o casi en su totalidad si duran menos de 10 segundos.	day, week, days_28
`page_video_view_time`	Tiempo total, en milisegundos, que las personas vieron el video de tu página.	day
`page_uploaded_3s_to_15s_views_rate*`	Porcentaje de reproducciones de 3 a 15 segundos. Se mide en todos los activos de video subidos, incluida la actividad en publicaciones y publicaciones cruzadas o en su contenido compartido.
`page_uploaded_views_15s_count*`	Número total de reproducciones de al menos 15 segundos del video de tu página.
`page_uploaded_views_60s_excludes_shorter_unique_count_by_is_60s_returning_viewer*`	Daily video 60-second unique views on a page for uploaded videos by 60-second returning viewers. This metric counts only for videos that are 60 seconds or longer. 60-second returning viewers are the users who had 60-second view last week and a 60-second view this week.

Page Views

Metric Name	Description	Values for `period`
`page_views_total*`	Número de veces que personas que iniciaron sesión y no iniciaron sesión vieron el perfil de una página.	day, week, days_28

Page Video Posts

Metric Name	Description	Values for `period`
`post_video_avg_time_watched`	Tiempo promedio, en milisegundos, que las personas reprodujeron tus videos. Solo disponible para los videos creados después del 25 de agosto de 2016. Devuelve 0 para los videos compartidos.	lifetime
`post_video_complete_views_organic`	Número de veces que se reprodujeron tus videos desde el principio hasta el 97% o más de su duración mediante alcance orgánico. En una única instancia de reproducción de video, se excluirá el tiempo de las reproducciones repetidas. Devuelve 0 para los videos compartidos.	lifetime
`post_video_complete_views_organic_unique`	Número de personas que reprodujeron tus videos desde el principio hasta el 97% o más de su duración mediante alcance orgánico. En una única instancia de reproducción de video, se excluirá el tiempo de las reproducciones repetidas. Devuelve 0 para los videos compartidos.	lifetime
`post_video_complete_views_paid`	Número de veces que se reprodujeron tus videos promocionados desde el principio hasta el 97% o más de su duración. Para cada impresión de un video, se contarán las reproducciones por separado y se excluirá el tiempo de las reproducciones repetidas. Devuelve 0 para los videos compartidos.	lifetime
`post_video_complete_views_paid_unique`	Número de personas que vieron tus videos promocionados desde el principio hasta el 97% o más de su duración. Para cada impresión de un video, se contarán las reproducciones por separado y se excluirá el tiempo de las reproducciones repetidas.	lifetime
`post_video_retention_graph*`	Número de veces que se reprodujeron tus videos en cada intervalo como porcentaje del total de reproducciones. Los videos se dividen en 40 intervalos iguales. Esta métrica no cuenta las impresiones mientras el video estaba en vivo. Los gráficos de retención pueden mostrar más impresiones una vez avanzado el video que al principio. Es posible que las personas empiecen a verlo desde la mitad, lo adelanten, lo guarden y continúen viéndolo desde un momento concreto, u otros comportamientos similares.	lifetime
`post_video_retention_graph_clicked_to_play`	Número de veces que se reprodujeron tus videos en cada intervalo como porcentaje del total de reproducciones después de que las personas hicieron clic para reproducirlos. Los videos se dividen en 40 intervalos iguales. Esta métrica no cuenta las impresiones mientras el video estaba en vivo. Los gráficos de retención pueden mostrar más impresiones una vez avanzado el video que al principio. Es posible que las personas empiecen a verlo desde la mitad, lo adelanten, lo guarden y continúen viéndolo desde un momento concreto, u otros comportamientos similares.	lifetime
`post_video_retention_graph_autoplayed`	Número de veces que se reprodujeron tus videos automáticamente en cada intervalo como porcentaje del total de reproducciones automáticas. Los videos se dividen en 40 intervalos iguales. Esta métrica no cuenta las impresiones mientras el video estaba en vivo. Los gráficos de retención pueden mostrar más impresiones una vez avanzado el video que al principio. Es posible que las personas empiecen a verlo desde la mitad, lo adelanten, lo guarden y continúen viéndolo desde un momento concreto, u otros comportamientos similares.	lifetime
`post_video_views_organic`	Número de veces que se reprodujeron tus videos durante al menos 3 segundos, o casi en su totalidad si duran menos de 3 segundos, mediante alcance orgánico. En una única instancia de reproducción de video, se excluirá el tiempo de las reproducciones repetidas.	lifetime, day
`post_video_views_organic_unique`	Número de personas que vieron tus videos durante al menos 3 segundos, o casi en su totalidad si duran menos de 3 segundos, mediante alcance orgánico. En una única instancia de reproducción de video, se excluirá el tiempo de las reproducciones repetidas.	lifetime
`post_video_views_paid`	Número de veces que se reprodujeron tus videos promocionados durante al menos 3 segundos, o casi en su totalidad si duran menos de 3 segundos. Para cada impresión de un video, se contarán las reproducciones por separado y se excluirá el tiempo de las reproducciones repetidas.	lifetime, day
`post_video_views_paid_unique`	Número de personas que vieron tus videos promocionados durante al menos 3 segundos, o casi en su totalidad si duran menos de 3 segundos. Para cada impresión de un video, se contarán las reproducciones por separado y se excluirá el tiempo de las reproducciones repetidas.	lifetime
`post_video_length`	Duración, en milisegundos, de una publicación con video.	lifetime
`post_video_views`	Número de veces que se reprodujeron tus videos durante al menos 3 segundos, o casi en su totalidad si duran menos de 3 segundos. En una única instancia de reproducción de video, se excluirá el tiempo de las reproducciones repetidas. Esto incluye las reproducciones en vivo.	lifetime, day
`post_video_views_unique`	Número de personas que vieron tus videos durante al menos 3 segundos, o casi en su totalidad si duran menos de 3 segundos. En una única instancia de reproducción de video, se excluirá el tiempo de las reproducciones repetidas.	day, lifetime
`post_video_views_autoplayed`	Número de veces que se reprodujeron tus videos automáticamente durante al menos 3 segundos, o casi en su totalidad si duran menos de 3 segundos. En una única instancia de reproducción de video, se excluirá el tiempo de las reproducciones repetidas.	lifetime
`post_video_views_clicked_to_play`	Número de veces que se reprodujeron tus videos durante al menos 3 segundos, o casi en su totalidad si duran menos de 3 segundos, después de que las personas hicieron clic para reproducirlos. En una única instancia de reproducción de video, se excluirá el tiempo de las reproducciones repetidas.	lifetime
`post_video_views_15s*`	Número de veces que se reprodujeron tus videos durante al menos 15 segundos, o casi en su totalidad si duran menos de 15 segundos. En una única instancia de reproducción de video, se excluirá el tiempo de las reproducciones repetidas.	lifetime
`post_video_views_60s_excludes_shorter*`	Número de veces que se reprodujeron tus videos durante al menos 60 segundos. Esta métrica solo se contabiliza para los videos que duran 60 segundos o más. En una única instancia de reproducción de video, se excluirá el tiempo de las reproducciones repetidas.	lifetime, day
`post_video_views_10s`	Obsoleto a partir de Graph API v18: número de veces que se reprodujeron tus videos durante al menos 10 segundos, o casi en su totalidad si duran menos de 10 segundos. En una única instancia de reproducción de video, se excluirá el tiempo de las reproducciones repetidas.	lifetime, day
`post_video_views_10s_unique`	Obsoleto a partir de Graph API v18: número de personas que vieron tus videos durante al menos 10 segundos, o casi en su totalidad si duran menos de 10 segundos. Para cada impresión de un video, se contarán las reproducciones por separado y se excluirá el tiempo de las reproducciones repetidas.	lifetime
`post_video_views_10s_autoplayed`	Obsoleto a partir de Graph API v18: número de veces que se reprodujeron automáticamente tus videos durante al menos 10 segundos, o casi en su totalidad si duran menos de 10 segundos. En una única instancia de reproducción de video, se excluirá el tiempo de las reproducciones repetidas.	lifetime
`post_video_views_10s_clicked_to_play`	Obsoleto a partir de Graph API v18: número de veces que se reprodujeron tus videos durante al menos 10 segundos, o casi en su totalidad si duran menos de 10 segundos, después de que las personas hicieron clic para reproducirlos. En una única instancia de reproducción de video, se excluirá el tiempo de las reproducciones repetidas.	lifetime
`post_video_views_10s_organic`	Obsoleto a partir de Graph API v18: número de veces que se reprodujeron tus videos durante al menos 10 segundos, o casi en su totalidad si duran menos de 10 segundos, por alcance orgánico. En una única instancia de reproducción de video, se excluirá el tiempo de las reproducciones repetidas.	lifetime
`post_video_views_10s_paid`	Obsoleto a partir de Graph API v18: número de veces que se reprodujeron tus videos promocionados durante al menos 10 segundos, o casi en su totalidad si duran menos de 10 segundos. Para cada impresión de un video, se contarán las reproducciones por separado y se excluirá el tiempo de las reproducciones repetidas.	lifetime, day
`post_video_views_10s_sound_on`	Obsoleto a partir de Graph API v18: número de veces que se reprodujeron tus videos con el sonido activado durante al menos 10 segundos, o casi en su totalidad si duran menos de 10 segundos. En una única instancia de reproducción de video, se excluirá el tiempo de las reproducciones repetidas.	lifetime
`post_video_views_sound_on`	Número de veces que se reprodujeron tus videos con sonido activado durante al menos 3 segundos, o casi en su totalidad si duran menos de 3 segundos. En una única instancia de reproducción de video, se excluirá el tiempo de las reproducciones repetidas.	lifetime
`post_video_view_time`	Tiempo total, en milisegundos, que se reprodujeron tus videos, incluidas las reproducciones repetidas y las de menos de 3 segundos. Devuelve 0 para los videos compartidos.	lifetime, day
`post_video_view_time_organic`	Tiempo total, en milisegundos, que se reprodujeron tus videos mediante alcance orgánico. Devuelve 0 para los videos compartidos.	lifetime, day
`post_video_view_time_by_age_bucket_and_gender`	Tiempo total, en milisegundos, que se reprodujeron tus videos por públicos principales (edad y sexo).	lifetime
`post_video_view_time_by_region_id`	Tiempo total, en milisegundos, que se reprodujeron tus videos en los 45 lugares más populares (región y país).	lifetime, day
`post_video_views_by_distribution_type`	Número de veces que se reprodujeron tus videos por tipo de distribución (propiedad de la página o compartida).	lifetime
`post_video_view_time_by_distribution_type`	Tiempo total, en milisegundos, que se reprodujeron tus videos por tipo de distribución (propiedad de la página o compartida).	lifetime
`post_video_view_time_by_country_id`	Número total de minutos que se reprodujeron tus videos en los 45 lugares más populares (país).	lifetime
`post_video_views_live*`	Número total de personas que reprodujeron tu video durante más de 3 segundos durante el streaming en vivo.	lifetime
`post_video_social_actions_count_unique*`	Recuento único de acciones sociales (reacciones, comentarios y contenido compartido) en una publicación con video.	lifetime, day
`post_video_live_current_viewers*`	Número de espectadores que están viendo un video en vivo. La métrica solo se muestra para las publicaciones que se están transmitiendo en vivo en el momento. Devuelve 0 para las que ya finalizaron.
`post_video_15s_to_60s_excludes_shorter_views_rate*`	Porcentaje de reproducciones de 3 a 15 segundos para un video. Esta métrica de 60 segundos solo se calcula para los videos de más de 60 segundos de duración.
`post_video_views_by_live_status*`	Lifetime 3S Video Views broken down by live status: live or VOD

Stories

Page and Post Stories and "People talking about this".

Metric Name	Description	Values for `period`
`post_activity_by_action_type*`	Número de historias creadas acerca de la publicación de tu página, por tipo de acción.	lifetime
`post_activity_by_action_type_unique*`	Número de personas que crearon una historia sobre la publicación de tu página, por tipo de acción.	lifetime

Page Story Types

Name	Description
`checkin`	Page checkins
`coupon`	Offer claims
`event`	RSVPing to event
`fan`	Page likes
`mention`	Page mentions
`page post`	Posts by a Page
`question`	Question answers
`user post`	Posts by people on a Page
`other`	Other types

Video Ad Breaks

Metric Name	Description	Values for period
`page_daily_video_ad_break_ad_impressions_by_crosspost_status`	The total number of times an ad was shown during ad breaks in crossposted videos.	day
`page_daily_video_ad_break_cpm_by_crosspost_status`	The average amount paid by advertisers for 1,000 of impressions of their ads in a crossposted videos. This is a gross number and includes the amount paid to Facebook.	day
`page_daily_video_ad_break_earnings_by_crosspost_status`	An estimate of the amount you earned from ad breaks in a crossposted videos, based on the number of impressions and CPM of ads shown. Actual payments may differ if there are content ownership claims or other adjustments.	day
`post_video_ad_break_ad_impressions`	The total number of times an ad was shown during ad breaks in your videos.	day, lifetime
`post_video_ad_break_earnings`	An estimate of the amount you earned from ad breaks in your videos, based on the number of impressions and CPM of ads shown. Actual payments may differ if there are content ownership claims or other adjustments.	day, lifetime
`post_video_ad_break_ad_cpm`	The average amount paid by advertisers for 1,000 impressions of their ads in your videos. This number also includes the amount paid to Facebook.	day, lifetime
`creator_monetization_qualified_views`	The number of views of your videos that will receive a payout. To qualify for payout, your Page or profile must generate ad revenue in the current earning period. You must also be following the Partner Monetization Policies and Content Monetization Policies. There are additional factors which may disqualify a view for payout.	day,lifetime

Parámetros

Parámetro	Descripción
`breakdown` list<A valid breakdown for an insights endpoint>	breakdown for marketing messages metrics. This is currently in development.
`date_preset` enum{today, yesterday, this_month, last_month, this_quarter, maximum, data_maximum, last_3d, last_7d, last_14d, last_28d, last_30d, last_90d, last_week_mon_sun, last_week_sun_sat, last_quarter, last_year, this_week_mon_today, this_week_sun_today, this_year}	Preset a date range, like lastweek, yesterday. If since or until presents, it does not work.
`metric` list<A valid metric for an insights endpoint>	The list of metrics that needs to be fetched
`period` enum {day, week, days_28, month, lifetime, total_over_range}	The aggregation period
`show_description_from_api_doc` boolean	Valor predeterminado: `false` If set to true, then an additional description of the metric, retrieved from the API doc(https://developers.facebook.com/docs/graph-api/reference/insights) will be included in the returned data
`since` datetime	Lower bound of the time range to consider
`until` datetime	Upper bound of the time range to consider

Campos

La lectura de este perímetro mostrará un resultado con formato JSON:

{
    "data": [],
    "paging": {}
}

`data`

Una lista de nodos InsightsResult.

`paging`

Para obtener más detalles sobre la paginación, consulta la guía de la API Graph.

Error Codes

Error	Descripción
100	Invalid parameter
190	Invalid OAuth 2.0 Access Token
200	Permissions error
80001	There have been too many calls to this Page account. Wait a bit and try again. For more info, please refer to https://developers.facebook.com/docs/graph-api/overview/rate-limiting.
3001	Invalid query
104	Incorrect signature
368	The action attempted has been deemed abusive or is otherwise disallowed

Creación

No puedes realizar esta operación en este extremo.

Actualizando

No puedes realizar esta operación en este extremo.

Eliminando

No puedes realizar esta operación en este extremo.

Page Insights

Lectura

Nueva experiencia para las páginas

Limitations

Requirements

Example

Single Metric Sample Request

Multiple Metric Sample Request

Metrics

Page Content

Tab Types

Page CTA Clicks

Page Engagement

Page Impressions

Page Posts

Page Post Engagement

Negative Feedback Types

Page Post Impressions

Page Post Reactions

Page Reactions

Page User Demographics

Page Like Sources

Page Video Views

Page Views

Page Video Posts

Stories

Page Story Types

Video Ad Breaks

Parámetros

Campos

data

paging

Error Codes

Creación

Actualizando

Eliminando

See Also

`data`

`paging`