get_ad_insights
Retrieve ad performance metrics for an Instagram/Facebook ad account, including spend, impressions, reach, clicks, CPM, and CTR, over a selected date range.
Instructions
Get performance insights for your Instagram/Facebook ads.
Returns spend, impressions, reach, clicks, CPM, CTR. Requires ads_read permission.
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": "get_ad_insights"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| date_preset | No | last_7d | |
| ad_account_id | Yes | Ad account ID from get_ad_accounts (format: act_XXXXXXXX) |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |