Meta ad performance metrics
meta_insightsRead-only
Retrieve performance metrics like spend, impressions, and conversions for an ad account, campaign, ad set, or ad, with flexible date presets or custom range.
Instructions
Pull performance INSIGHTS (spend, impressions, reach, clicks, CTR, CPC, CPM, conversions) for a connected ad account, or a specific campaign / ad set / ad. Pass adAccountId (for auth); optionally objectId to scope to one object and level to break the numbers down. Date window: datePreset (today | yesterday | last_7d | last_30d | last_90d | this_month | lifetime …) OR since+until (YYYY-MM-DD). Read-only.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| level | No | break the numbers down by this level | |
| since | No | start date YYYY-MM-DD (use with until) | |
| until | No | end date YYYY-MM-DD | |
| objectId | No | a campaign / ad set / ad id to scope to (default: the whole account) | |
| datePreset | No | today | yesterday | last_7d | last_30d | last_90d | this_month | lifetime … (default last_30d) | |
| adAccountId | Yes | ad account id (act_… or digits) |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| rows | No | ||
| objectId | No |