Meta Ads / API Reference
meta_ads_page_insights_extended
Meta Ads tool. Get comprehensive Facebook Page insights including fans, views, reactions, and engagement. Args: page_id: Facebook Page ID (required). Run meta_ads_pages to list the Pages every connected login can reach. metrics: Comma-separated metric names. Default includes impressions, reach, engagement, fans, views. period: 'day', 'week', 'month', or 'lifetime'. Default day. start_date: Start date YYYY-MM-DD. Defaults to 28 days ago. end_date: End date YYYY-MM-DD. Defaults to today. page_access_token: Page access token. Optional -- when omitted it is looked up from page_id across every connected Meta login. Pass one explicitly to force a specific Page identity.
This is a read-only tool: it returns page insights extended for your Meta Ads account. It changes nothing.
Ask Claude
You do not call this tool yourself. Ask for the outcome and the client picks the tool:
Page insights extended in my Meta Ads account for [page id].
It takes 1 required and 5 optional parameters.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
page_id | string | Yes | Page Id |
metrics | string | No | Metrics |
period | string | No | Period |
start_date | string | No | Start Date |
end_date | string | No | End Date |
page_access_token | string | No | Page Access Token |
Related Meta Ads tools
meta_ads_page_insightsmeta_ads_page_albumsmeta_ads_page_blocked_usersmeta_ads_page_conversationsmeta_ads_page_ctameta_ads_page_events
Before you can call it
This tool needs a connected Meta Ads account. The Meta Ads connect guide covers the OAuth flow and the permissions it asks for, and the quickstart gets a client talking to the server in about five minutes.
Workflows that use this
Rather than calling tools one at a time, these skills run a whole procedure against the same account:
Start free — 30 tool calls a month
No card required. Connect Google Ads, Meta Ads, GA4 or Search Console and ask Claude for the outcome — it picks the tool.