Meta Ads / API Reference
meta_ads_page_insights
Meta Ads tool. Get Meta Page insights: reach, impressions, and engagement metrics for a Facebook Page. Args: page_id: Facebook Page ID (required). start_date: Start date YYYY-MM-DD. Defaults to 28 days ago. end_date: End date YYYY-MM-DD. Defaults to today.
This is a read-only tool: it returns page insights 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 in my Meta Ads account for [page id].
It takes 1 required and 2 optional parameters.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
page_id | string | Yes | Page Id |
start_date | string | No | Start Date |
end_date | string | No | End Date |
Related Meta Ads tools
meta_ads_page_insights_extendedmeta_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: