page_insights
Read Page-level metrics such as reach, engagement, follower growth, video views, reactions, and demographics for a chosen period or date range.
Instructions
Read Page metrics Read Page-level metrics (reach, engagements, follower growth, video views, reactions, demographics). Pass one or more metric names, a period (day, week, days_28, lifetime) and either date_preset or since/until. Call page_insights_metrics for a list of metric names to try. Graph API: GET {page_id}/insights. Requires a token that can perform the ANALYZE task, and Pages with fewer than 100 likes return no insights. Some metrics are deprecated in newer API versions; an invalid-metric error names the metric that failed.
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>",
"metrics": "<metrics>"
},
"name": "page_insights"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| since | No | ||
| total | No | ||
| until | No | ||
| period | No | ||
| metrics | Yes | ||
| page_id | Yes | ||
| breakdown | No | ||
| date_preset | No | ||
| access_token | No | Optional Facebook Page access token for this call only. Use it when the token you hold is not the one this server was configured with, or when the configured token has expired. Takes effect for this call and nothing else. Also accepted as token or page_token. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||