get_page_insights
Retrieve Facebook Page performance insights for reach, impressions, engagement, and more. Specify metrics, date ranges, and aggregation periods to analyze page growth and audience behavior.
Instructions
Get performance insights for a Facebook Page (reach, impressions, engagement, etc.). Requires pages_read_engagement permission. Args: page_id: The ID of the Facebook Page. metric: List of metrics to retrieve. Common values: page_impressions, page_impressions_unique, page_reach, page_engaged_users, page_post_engagements, page_fans, page_fans_online, page_video_views, page_views_total, page_actions_post_reactions_total. period: Aggregation period — day, week, days_28, month, lifetime. date_preset: Preset date range, e.g. last_7d, last_30d, last_90d. since: Start date as UNIX timestamp or YYYY-MM-DD string. until: End date as UNIX timestamp or YYYY-MM-DD string. Returns: A dictionary containing the Page metrics data.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"page_id": "<page_id>",
"metric": "<metric>"
},
"name": "get_page_insights"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| since | No | ||
| until | No | ||
| metric | Yes | ||
| period | No | day | |
| page_id | Yes | ||
| date_preset | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |