meta_get_overview
Account totals (spend, View Content → Add to Cart, cost per ATC, leads — form vs website — and cost per lead, conversations), the daily series, campaigns and the top ads for a period, from the last sync.
read meta_get_overview
Account totals (spend, View Content → Add to Cart, cost per ATC, leads — form vs website — and cost per lead, conversations), the daily series, campaigns and the top ads for a period, from the last sync. funnel is the operator's funnel over the totals — each step's count, its rate from the step before, and spend per step — and topAds — live ads only, delivering now — is ranked by its deepest step. campaigns lists every campaign that spent, live marking the ones with a delivering ad; notLive counts the paused ads the totals still include. Covers what the daily warehouse holds (see coverage); per-ad lifetime totals are in the account history. Purchases/ROAS are blank when that pixel did not fire.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
period | 7d | 14d | 30d | this_week | last_week | No | Reporting window. 7d/14d/30d are the last N complete days, ending yesterday (as in Ads Manager); weeks are Monday-based, this_week runs to today. UTC. |
since | string | No | Custom window start, YYYY-MM-DD, UTC. Overrides period. The result's coverage says what the warehouse holds. |
until | string | No | Custom window end, YYYY-MM-DD, inclusive. Default today. |
Performance & reports
Account overview, per-ad performance, breakdowns, the performance cube, strategy rollups and saved report views.
get_ad_performanceread
Per-ad metrics for a period: spend, View Content, Add to Cart, VC→ATC rate, cost per ATC, leads (form / website) and cost per lead, conversations, plus purchase ROAS/CPA/AOV when that pixel fired, CPC (link), landing page views (cost, rate per link click), click→lead rate, checkouts and registrations with their costs, hook/hold, video retention (25/50/75/95/100% view rates over 3-second plays, average watch time — null on statics and on days synced before retention was stored), and the persona / angle / concept parsed from the ad name.