Read Meta Ads performance
get_meta_ads_performanceThe connected Meta ad account's Facebook and Instagram ads for a date range, from what the daily pull stored: totals (spend, impressions, link clicks, CTR, CPC, CPM, purchases, leads, registrations, adds to cart and their value, ROAS), each campaign most spend first, and the landing pages the ads send people to. Reach shows for the last 30 or 90 stored days only, as Meta counts people per period. Money is in the account's currency (currencyCode). Results count within 7 days of a click or 1 day of a view. At most 90 days. Read-only; uses no credits.
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": {
"projectId": "<projectId>"
},
"name": "get_meta_ads_performance"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| endDate | No | Last day (YYYY-MM-DD). Use with startDate. Without both, the last 30 stored days. At most 90 days. | |
| projectId | Yes | Required. The Visibility Genies project this call works in and is billed to. Call list_projects to find one. | |
| startDate | No | First day (YYYY-MM-DD, the ad account's time zone). Use with endDate. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ok | Yes | ||
| meta | No | ||
| reason | No | ||
| totals | No | ||
| endDate | No | ||
| message | No | ||
| failedAt | No | ||
| campaigns | No | ||
| startDate | No | ||
| connectUrl | No | ||
| accountName | No | ||
| attribution | No | ||
| currencyCode | No | ||
| landingPages | No | ||
| storedThrough | No |