Get Campaign Insights
meta_get_campaign_insightsRetrieve performance metrics for Meta ad campaigns, including spend, impressions, clicks, and actions, with options to filter by campaign, date range, and demographic breakdowns.
Instructions
Gets performance insights for campaigns in a Meta ad account.
Args:
ad_account_id (string): Ad account ID
campaign_id (string, optional): Specific campaign ID (omit for all campaigns)
date_preset (string): Date range preset (default: last_30d)
since (string, optional): Custom start date YYYY-MM-DD
until (string, optional): Custom end date YYYY-MM-DD
breakdowns (string[], optional): Segment by age, gender, country, device_platform, etc.
Returns per-campaign spend, impressions, clicks, CTR, and actions.
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": {
"ad_account_id": "<ad_account_id>"
},
"name": "meta_get_campaign_insights"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ad_account_id | Yes | ||
| campaign_id | No | Specific campaign (omit for all) | |
| date_preset | No | Date range preset | last_30d |
| since | No | ||
| until | No | ||
| breakdowns | No | Breakdown dimensions for segmented data | |
| response_format | No | Output format: 'markdown' for human-readable or 'json' for machine-readable | markdown |