insights

Description

An FQL table containing statistics about Applications, Pages, and Domains with 30 or more connections. Graph API objects have an equivalent Insights connection type.

Name	Description
breakdown string	The breakdown requested for a custom_events query.
end_time number	The end of the period during which the metrics were collected, expressed as a UNIX time (which should always be midnight, Pacific Daylight Time) or using the function end_time_date() which takes a date string in 'YYYY-MM-DD' format. Note: If the UNIX time provided is not midnight, Pacific Daylight Time, your query may return an empty resultset. Example: To obtain data for the 24-hour period starting on September 15th at 00:00 (i.e. 12:00 midnight) and ending on September 16th at 00:00 (i.e. 12:00 midnight), specify 1284620400 as the end_time and 86400 as the period. Note: end_time should not be specified when querying lifetime metrics
event string	The event name for a custom_events query. This must be specified if the metric is custom_events. It can not be specified for any other metrics.
metric string	The usage data to retrieve
object_id string	The object for which you are retrieving metrics
period string	The length of the period during which the metrics were collected, expressed in seconds as one of 86400 (day), 604800 (week), 2592000 (month) or 0 (lifetime) or using the function period() which takes one of the strings day, week, month or lifetime. Note: Each metric may not have all periods available
value (number) or (string) or (list) or (list) or (map with string keys)	The value of the requested metric

SELECT ... FROM insights WHERE object_id = A AND metric = B AND end_time = C AND period = D

Note: Additional filters on other columns can be specified but they may make the query less efficient.

To read insights you need:

Any valid access_token for the publicly available application_active_users metric
An app access_token for all app insights app
read_insights permissions for all apps, Pages and domains owned by the current session user

Use Facebook Insights to claim your domain.

For more details on which insights are available please review the Graph API Insights object