An object containing statistics about applications, pages, and domains.

The Page, Application and Domain objects have an insights connection of this type. Post objects also have this connection where the Post was made by a Page.

Available metrics include application and page hits, adds, removes, and likes.

Use Facebook Insights to claim your domain.

Insights can be retrieved only as an array. To read Insights you need

• a generic access_token for the publicly available application_active_users metric
• a generic app access_token for all Insights for that app
• read_insights permissions for all apps, pages and domains owned by this user

For more details on which insights are available please review the FQL Insights table

Example

The application active users metric on the Graffiti app:

https://graph.facebook.com/2439131959/insights/application_active_users&since=1329724800&until=1329984000

Note: That start and end dates can be applied using since and until unix timestamps based on midnight in PST described in UTC.

---

Fields

The Insights object has the following fields.

Name	Description	Permissions	Returns
id	ID of the insight	generic access_token or read_insights	string
name	Name of the metric	generic access_token or read_insights	string
period	Length of the period during which the insights were collected	generic access_token or read_insights	string
values	Individual data points for the insight	generic access_token or read_insights	array of objects containing value and end_time
description	The full description of the metric	generic access_token or read_insights	string